MCP tools reference.
Stori hosts an MCP server at https://app.stori.zone/api/mcp exposing the full API as MCP tools. Connect over HTTP, authorize in the browser, no install. The sections below cover the most common reads and writes. Your agent sees every tool the server exposes via the MCP `tools/list` capability — use search_documentation to find ones not listed here (canvas areas, releases, billing, ops log, &c.).
Multi-org users:each connection acts within a single organization — the one it's pinned to. OAuth connections start on your personal org; switch a connection's org anytime under Settings → Account → API keys. API-key installs are pinned by the key's org. To work in two orgs at once, add a second connection.
One-line install (recommended)
Auto-detects your MCP client (Claude Code, Cursor, Codex, Cline, Continue, Windsurf, Claude Desktop), emails you a verification link, then writes the right config block:
curl https://app.stori.zone/install | sh
Enter your email when prompted. Click the verification link in your inbox. The script writes an API key into your client's config and prints "Done. Restart <client> to load the MCP server."
If multiple MCP clients are detected, the script asks which one to install for. For CI / agent-driven installs, pass --non-interactive --email=<addr> --client=<name> --agree-to-tos — valid client names: claude-code, codex, cursor, cline, continue, windsurf, claude-desktop. Interactive installs accept the Terms on the verification page instead.
The installer writes a user-global config and chmod 600s it — the key is long-lived, so it's kept owner-only and out of any checked-in file. If you want a shared or committed config, use the bare-URL OAuth connection instead (rotating token, nothing static to leak) rather than baking a key into .mcp.json.
Other clients (manual install)
If the one-line installer doesn't fit your setup (different MCP client, locked-down machine, syncing config across hosts), generate an API key at /settings → API keys, then paste the block for your client below — replace <API_KEY> with the key you generated.
If the Claude Code CLI is on your PATH, the easiest path is OAuth — no API key needed:
claude mcp add --transport http stori https://app.stori.zone/api/mcp
Then run /mcp inside Claude Code to authorize in the browser. Otherwise add this to ~/.claude.json:
{
"mcpServers": {
"stori": {
"type": "http",
"url": "https://app.stori.zone/api/mcp",
"headers": { "Authorization": "Bearer <API_KEY>" }
}
}
}