SaveSlot Docs

Developers

Developer overview

If your product has an agent, or needs per-user state your agent can trust, you can build on SaveSlot. Developer tools are under Developers in the console.

Two paths

PathWhen to use itHow
MCP + SkillsYour product has an agentPoint it at the hosted MCP server and give it the SaveSlot skills. It reads and writes the same way Claude or ChatGPT does. See MCP tools
HTTP APIYou want to read and write from your own backendCall the REST API with an API key or an OAuth token. See HTTP API reference

The open-source kernel exposes the same ten MCP tools, so what you build works against a self-hosted copy too.

Where your users' data lives

Choose one before you start:

ModelHow it worksTrade-off
Each user owns a SaveSlot account (recommended)Your app asks for access with OAuth, like an agent does. Users see your app under Connect agents and can revoke itTheir data stays theirs when they leave your product
You keep the data in your accountOne slot per end user under your account, accessed with an API keySimpler to start, but your users cannot see or take their data

API keys

  • Create a key under Developers → API keys. Give it a name, choose read only or read and write, and pick the slot it can reach. A key reaches one slot.
  • The key is shown once. Copy it then; it cannot be shown again.
  • Calls with a key appear in Activity and count toward Usage.
  • Revoke a key at any time. Calls with it fail from then on.

Keys start with ss_ro_ (read only) or ss_rw_ (read and write). Send them as a bearer token:

curl https://api.saveslot.ai/v1/slots/SLOT_ID/tables/meals/records \
  -H "Authorization: Bearer ss_rw_…" \
  -d '{"what": "Beef noodles", "calories": 650, "trust": "inferred"}'

OAuth apps

Register your product under Developers → OAuth apps so your users can authorize it from their own SaveSlot accounts. The redirect URL must use https://; http://localhost and http://127.0.0.1 are accepted for development. See OAuth apps.

Pricing

The developer API is billed by usage. Write to [email protected] to set it up.