MCP server

Orbitrage exposes its analytics toolbox as a Model Context Protocol server — the same org-scoped tools as Ask Analytics, over JSON-RPC 2.0.

Endpoints

Endpoint	Transport	Use from
`POST https://api.orbitrage.ai/api/mcp`	Streamable HTTP (one-shot JSON-RPC)	VS Code, Cursor (HTTP), curl
`GET https://api.orbitrage.ai/api/mcp`	Health probe	Sanity checks
`GET https://api.orbitrage.ai/api/mcp/sse` + `POST .../api/mcp/messages`	Legacy SSE	Claude Desktop via `mcp-remote`

Get an MCP key

MCP uses its own key namespace, separate from your orb_ router keys.

Create the key

On the dashboard’s Customise page, create an MCP key. It looks like mcp_a1b2c3d4_… and is shown once.

Authenticate

Send it as Authorization: Bearer mcp_… (or ?key=mcp_… for clients that can’t set headers).

An MCP key can only call /api/mcp — it cannot make LLM calls. An orb_ key cannot call /api/mcp. Revoking is immediate with no un-revoke; mint a new key to restore access.

Client setup

Claude Desktop
VS Code
Cursor

SSE transport via mcp-remote. Add to claude_desktop_config.json:

{
  "mcpServers": {
    "orbitrage": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.orbitrage.ai/api/mcp/sse",
        "--transport", "sse-only",
        "--header", "Authorization: Bearer mcp_..."
      ]
    }
  }
}

Claude Desktop can also auto-mint a key via the built-in OAuth flow (the server implements OAuth 2.0 authorization-server metadata, dynamic client registration, token, and revoke), so mcp-remote can authenticate without a pasted key.

Native HTTP transport. Add to .vscode/mcp.json:

{
  "servers": {
    "orbitrage": {
      "type": "http",
      "url": "https://api.orbitrage.ai/api/mcp",
      "headers": { "Authorization": "Bearer mcp_..." }
    }
  }
}

Settings → MCP → Add new server, pointing at the Streamable HTTP endpoint https://api.orbitrage.ai/api/mcp with an Authorization: Bearer mcp_… header.

JSON-RPC methods

Method	Behavior
`initialize`	Handshake — server name, version, protocol version, capabilities.
`tools/list`	The analytics tool catalog as MCP Tools.
`tools/call`	Run one tool (logged to your session audit).
`ping`	Returns `{}`.

Quick check with curl

# Health
curl -sS https://api.orbitrage.ai/api/mcp \
  -H "Authorization: Bearer mcp_..."

# List tools
curl -sS -X POST https://api.orbitrage.ai/api/mcp \
  -H "Authorization: Bearer mcp_..." \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Run one
curl -sS -X POST https://api.orbitrage.ai/api/mcp \
  -H "Authorization: Bearer mcp_..." \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"count_calls","arguments":{"range":"24h"}}}'

Get Started

Core Concepts

SDKs

Integrations

Examples

Dashboard

Platform

Account & Billing

Endpoints

Get an MCP key

Client setup

JSON-RPC methods

Quick check with curl

​Endpoints

​Get an MCP key

​Client setup

​JSON-RPC methods

​Quick check with curl

Endpoints

Get an MCP key

Client setup

JSON-RPC methods

Quick check with curl