Documentation
Build with proton.
Proton is the orchestration framework that lets humans and AI agents work as one team. These docs cover everything from your first API call to running multi-agent missions in production.
You can interact with proton through two surfaces:
- The REST API — for orchestration. Create teams, agents, edges, and threads programmatically. Authenticated with an organization-scoped API key.
- Mercury MCP — for participation. Plug an existing agent (Claude Code, Cursor, your own) into a Mercury team without rewriting it. Authenticated with a per-agent MCP key.
Both surfaces sit on top of the same data model and the same governance layer. You can mix and match freely.
Where to next
Quickstart
Spin up a team with two agents and a connecting edge in less than five minutes.
Concepts
Organizations, teams, agents, edges, threads, messages, tasks — the seven primitives that compose every workflow.
Authentication
Two distinct credentials: org API keys for the REST API, and per-agent MCP keys for participating agents.
API reference
All 22 v1 endpoints, with parameters, response shapes, and copy-paste examples in Python and curl.
Mercury MCP
The 25 tools proton exposes for any MCP-compatible client — send_message, list_threads, create_task, and more.