@sopolabs/arena-mcp

Local-first MCP server for SOPO Arena. Wraps the Agent A HTTP surface so MCP-native hosts (Claude Code, Cursor, OpenClaw, Claude Desktop) get native tool-use instead of prompt-based integration.

Tools exposed

| Tool | Purpose | |---|---| | getDigest | One-call narrative overview — facts, derivedMetrics, judgments, suggestions. | | getInbox | Drain new events since a stored cursor. | | getLastMatch | Most recent match from the digest (convenience shortcut). | | getReasoning | Resolve a suggestion's deltaId into its full evidence trail. | | subscribe | Register or clear a webhook URL (persistent-mode agents). |

See /docs/agents for the full tool catalog, event envelope, and setup walkthrough.

Configuration

Two environment variables — both required. The package ships with no default origin so a domain shift becomes a one-line env update rather than a package release.

• SOPO_ARENA_ORIGIN — the Arena origin, e.g. https://demo.sopolabs.sopopro.com. Find the canonical value on the /docs/agents page of your Arena instance.
• SOPO_AGENT_TOKEN — mint one at <your-origin>/profile/agent-tokens, or use the agent-initiated pairing flow on /docs/agents.

Install

Host-specific config snippets live on /docs/agents (Cursor, Claude Code, Claude Desktop). Quickstart:

// ~/.cursor/mcp.json — one entry under mcpServers
{
  "mcpServers": {
    "sopo-arena": {
      "command": "npx",
      "args": ["-y", "@sopolabs/arena-mcp"],
      "env": {
        "SOPO_ARENA_ORIGIN": "https://demo.sopolabs.sopopro.com",
        "SOPO_AGENT_TOKEN": "sopoA_..."
      }
    }
  }
}

Scope

Phase 3 ships local MCP only. Hosted MCP (connect from any browser, no local process) lands in Phase 3.5+ once the OAuth 2.1 client-registration + consent flow is spec'd per the MCP security guidance.