Connect your agent

Add the Agora MCP server to Claude Code, Codex or any MCP client, install the Agora skill and read these docs as Markdown.

Agents talk to Agora through agora mcp, a stdio MCP server that forwards every tool call to the daemon’s HTTP API. Run it on the same machine as the daemon.

Before you start

Agora must be installed and running (install). Check it:

agora api GET /v1/health

{"ok":true,...} means the daemon is up.

Get a cursor token

Give each agent its own cursor token. With a cursor token the server knows who the agent is and which workspace it works in, so tools do not ask for a workspace argument, and the agent can only reach its own workspace.

WS=$(agora api POST /v1/workspaces '{"name":"main"}' | jq -r .id)
agora api POST /v1/cursors "{\"name\":\"claude\",\"workspace\":\"$WS\"}" | jq -r .token

The token is shown once; Agora stores only a hash. To limit what the agent can do, add "permissions" (see security).

Claude Code

claude mcp add agora -e AGORA_TOKEN=<cursor token> -- agora mcp

Or install the Claude Code plugin, which bundles the skill and the MCP server:

/plugin marketplace add olimpiacloud/agora-skills
/plugin install agora@agora

Codex

codex mcp add agora --env AGORA_TOKEN=<cursor token> -- agora mcp

Any MCP client

Cursor, VS Code, Windsurf and other clients with a JSON config:

{
  "mcpServers": {
    "agora": {
      "command": "agora",
      "args": ["mcp"],
      "env": { "AGORA_TOKEN": "<cursor token>" }
    }
  }
}

Restart the agent session after adding the server so the tools load.

Environment variables

A lean setup for an agent that only browses and spawns subagents:

claude mcp add agora -e AGORA_TOKEN=<cursor token> -e AGORA_TOOLS=browser,spawn -e AGORA_LEAN=1 -- agora mcp

If the agent runs on another machine, run agora mcp there and point AGORA_URL at an authenticated tunnel to the daemon. Never open port 7788 to the internet.

Paseo

With the Paseo plugin, every Claude or Codex agent in Paseo gets the Agora MCP server and its own cursor automatically. You do not need to run the commands above.

Subagents launched by Agora

Agents that Agora starts with cursor_spawn and launch already have the MCP server configured with their own scoped token. See subagents.

The Agora skill

The skill teaches agents how to work with Agora: act and read the observation that comes back, use refs instead of coordinates, spawn and wait for subagents, and ask for a human on CAPTCHAs.

bunx skills add olimpiacloud/agora-skills

It works with Claude Code, Codex, Cursor and other agents with skills support. Remove it with bunx skills remove agora. The source is at github.com/olimpiacloud/agora-skills.

Docs for agents

These docs are also published in formats agents can read directly: