# Rig — developer docs

One hosted MCP endpoint that gives a personal AI agent a bundle of capabilities.
Sign up, create a token, point any MCP-compatible client at the endpoint.

## Connect

```
Endpoint: https://rig.notpritam.in/mcp
Transport: Streamable HTTP
Auth: Authorization: Bearer rig_live_xxxxxxxx
```

Example `mcpServers` config:

```json
{
  "mcpServers": {
    "rig": {
      "type": "http",
      "url": "https://rig.notpritam.in/mcp",
      "headers": { "Authorization": "Bearer rig_live_xxxxxxxx" }
    }
  }
}
```

Get a token from your dashboard at https://rig.notpritam.in/app.

## Live tools

### Memory

Persistent long-term memory: save facts and notes, then search and recall them across sessions.

- `memory_write`
- `memory_search`
- `memory_list`
- `memory_delete`

## REST API (/v1)

The same store is a token-authed REST API — for scripts, hooks, and anything that
isn't an MCP client. Machine-readable spec: [`https://rig.notpritam.in/openapi.json`](https://rig.notpritam.in/openapi.json).

```bash
# search
curl -s "https://rig.notpritam.in/v1/memories?q=coffee" -H "Authorization: Bearer rig_live_…"
# create
curl -s -X POST "https://rig.notpritam.in/v1/memories" -H "Authorization: Bearer rig_live_…" \
  -H "content-type: application/json" -d '{"content":"remember this","kind":"note"}'
# delete
curl -s -X DELETE "https://rig.notpritam.in/v1/memories/mem_…" -H "Authorization: Bearer rig_live_…"
```

## The bundle (Claude Code)

One command installs the MCP server + auto-recall/journal hooks + skills + slash
commands, and keeps itself updated:

```bash
curl -fsSL https://rig.notpritam.in/init.sh | RIG_TOKEN=rig_live_… sh
```

## Build on Rig

Rig is a platform, not just an endpoint. Your second brain is reachable over MCP
and REST, so you can build a custom app, a link, or a bb extension on top — the
way Atlas and Mailroom were built on their capabilities. Start from
[`openapi.json`](https://rig.notpritam.in/openapi.json) or the MCP tools.

## Notes

- The endpoint is stateless request/response; there is no server-initiated
  channel (no notifications/sampling) in this version.
- Every call is scoped to the token's owner; you only ever see your own data.
- Usage is metered per account (1 credit per tool call; auto-journal is free).
  Free during beta.
