@orrery-labs/mcp

Local stdio MCP bridge for Orrery.

Use this package when an MCP client prefers launching a local server process instead of connecting directly to Orrery's remote HTTP endpoint.

The bridge is intentionally thin:

Claude / Cursor / local agent
        ↓ stdio MCP (Content-Length framed JSON-RPC)
@orrery-labs/mcp
        ↓ HTTPS JSON-RPC
https://orrery.me/api/mcp/v1
        ↓
Orrery x402/API-credit tools

It does not duplicate Orrery taxonomy, pricing, Kalshi, alert, or signal logic. All tool calls are forwarded to the canonical remote MCP endpoint.

Install

npx @orrery-labs/mcp

Claude Desktop

{
  "mcpServers": {
    "orrery": {
      "command": "npx",
      "args": ["-y", "@orrery-labs/mcp"],
      "env": {
        "ORRERY_API_KEY": "orrery_live_..."
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "orrery": {
      "command": "npx",
      "args": ["-y", "@orrery-labs/mcp"],
      "env": {
        "ORRERY_API_KEY": "orrery_live_..."
      }
    }
  }
}

Configuration

| Env var | Default | Purpose | |---|---|---| | ORRERY_MCP_URL | https://orrery.me/api/mcp/v1 | Remote MCP endpoint | | ORRERY_API_KEY | unset | Orrery API-credit key, forwarded as X-Orrery-API-Key | | ORRERY_X_PAYMENT | unset | x402 payment proof, forwarded as X-PAYMENT | | ORRERY_PAYMENT_SIGNATURE | unset | x402 payment proof, forwarded as PAYMENT-SIGNATURE | | ORRERY_MCP_STDIO_FRAMING | content-length | Use newline only for local smoke tests |

CLI flags mirror the env vars:

orrery-mcp --url https://orrery.me/api/mcp/v1 --api-key orrery_live_...

For quick shell smoke tests that send one JSON-RPC object per line:

ORRERY_MCP_STDIO_FRAMING=newline orrery-mcp --url http://localhost:3000/api/mcp/v1

Safety

Orrery is read-only. The MCP bridge exposes intelligence tools, resources, and prompts. It does not trade, submit orders, connect to Polymarket/Kalshi accounts, read private positions, or provide buy/sell recommendations.