AgentPlayground
Docs
Drive it from any LLM

AgentPlayground exposes an MCP (Model Context Protocol) endpoint plus a simple REST push endpoint,
so tools like Claude Desktop, Claude mobile, ChatGPT, Cursor, or your own scripts can read from and
write to your Brain and dispatch tasks — not just the in-app chat window. The in-app Connect
page (/connect) is the real, working setup guide for all of this, with copy-paste configs per
tool; this page explains what's actually happening underneath.

Getting your API key

Open Connect in the app and generate a key (POST /api/settings/api-key) — it's shown once,
copy it somewhere safe. Every request below authenticates with Authorization: Bearer YOUR_KEY.

The MCP endpoint (/api/mcp)

A JSON-RPC 2.0 endpoint (protocol version 2024-11-05) exposing these tools to any MCP-compatible
client:

| Tool | What it does |
|---|---|
| vault_search / search_brain | Semantic search across Brain notes |
| vault_read | Read a specific note by path |
| vault_write | Save a new note to the vault inbox |
| get_context | Vault notes + active projects for a topic, in one call |
| list_teams | List available agent teams |
| ask_team | Delegate a message/task to a specific team, get its result |
| run_agent | Run one specific agent directly on a prompt |
| create_task / list_tasks | Create/list tasks assigned to a team |
| dispatch_task | Hand a task to the coordinator to route to the best team |

Claude Desktop (Mac/Windows): add a server entry to claude_desktop_config.json pointing at
/api/mcp with your bearer key, restart — tools appear under the hammer icon.
Claude mobile: Settings → Integrations → Add Integration → Custom, same URL + header.
Cursor / VS Code: Settings → MCP → Add MCP Server, same config shape.

The REST push endpoint (/api/brain/push)

A plain HTTP endpoint for anything that isn't MCP-aware — n8n, Make, Zapier, a ChatGPT Custom GPT
Action, or a raw curl:

POST https://<your-domain>/api/brain/push
Authorization: Bearer YOUR_KEY
Content-Type: application/json

{ "title": "...", "content": "...", "team": "optional team name", "tags": ["tag1"] }

Setting team routes the note into Teams/<team>/ so the right agents see it first instead of a
generic inbox. GET the same URL to fetch its OpenAPI schema — useful as the Schema URL when
wiring up a ChatGPT Custom GPT Action directly.

Which one should I use?
  • Want an assistant to read your Brain, delegate tasks, or have a back-and-forth — use MCP (Claude Desktop/mobile, Cursor).
  • Just want to push content one-way from automation (n8n, Zapier, a script) — use the REST push endpoint, it's simpler and doesn't need an MCP client.