orcatrace-mcp

MCP server for OrcaTrace — pay-per-call Polymarket intelligence for AI agents. Track smart money and see what others miss across 42K prediction markets: quality-gated repricings with order-book microstructure, tracked-whale entries annotated with each wallet's hold-to-resolution calibration (follow or fade), AI-detected predetermined-outcome markets, on-demand single-market research, and 4-hourly synthesized digests — one unified, index-polled feed.

Pay per call with USDC on Base via x402 — no account, no API key.

• 5 free tools — no wallet, no API key.

• 8 paid tools — flat per-call USD prices ($0.01–$1.00), settled in USDC on Base Mainnet via x402.

The whale track record is free and verifiable. get_track_record publishes the aggregate hold-to-resolution win rate, follow/fade ROI, per-odds-band breakdown, and top wallets with full public addresses — so you can cross-check every claim on Polymarket before you pay. Preview every paid response shape free with get_sample.

Quick start

Free tier (no wallet)

{
  "mcpServers": {
    "orcatrace": {
      "command": "npx",
      "args": ["-y", "orcatrace-mcp"]
    }
  }
}

You get get_index, get_pulse, get_digest_brief, get_sample, get_track_record.

Paid tier (with wallet)

Add an EVM wallet private key (0x-prefixed) that holds USDC on Base Mainnet:

{
  "mcpServers": {
    "orcatrace": {
      "command": "npx",
      "args": ["-y", "orcatrace-mcp"],
      "env": { "PRIVATE_KEY": "0x..." }
    }
  }
}

The paid tools then settle each call automatically.

Install snippets

Claude Code:

claude mcp add orcatrace -- npx -y orcatrace-mcp
# with a wallet:
claude mcp add orcatrace --env PRIVATE_KEY=0x... -- npx -y orcatrace-mcp

Claude Desktop / Cursor: add the JSON block above to your MCP config (claude_desktop_config.json or .cursor/mcp.json).

Related MCP server: predmarket-mcp

Tools

Free tools

Paid tools

Prices are flat per call — no bundles, no entitlements. Confirm live prices any time via the free get_sample / the site.

How payments work (x402)

OrcaTrace speaks the x402 exact scheme. The API's 402 advertises a Base (USDC, EIP-3009) rail; this MCP settles on Base:

1. The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with the accepted terms.

2. If PRIVATE_KEY is set, the MCP settles the call via the standard @x402/fetch V2 client and retries. If no key is set, the MCP returns the 402 price terms so you can see the cost without paying.

3. The API returns the data plus a payment block.

You are never charged for an error. The feed and digest routes are compute-first / settle-after — the full answer is computed before you are charged, and the digest returns 503 (no charge) rather than serving stale. The proxied-compute routes (get_resolving, get_whales, get_research) settle-early with a guaranteed refund — if the API charges but cannot deliver, the payment is refunded.

No accounts, no API keys — just a wallet with USDC on Base Mainnet.

Environment variables

Disclaimer

OrcaTrace provides informational prediction-market data and analysis aggregated from public sources. Whale calibration measures entries held to resolution, not trader P&L. Nothing here is financial advice, and everything is provided as-is without warranty. See https://api.orcatrace.dev/terms.txt.

Docs for agents: https://api.orcatrace.dev/llms.txt · full: https://api.orcatrace.dev/llms-full.txt

License

MIT © jcislo