Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@orcatrace-mcp What's the latest market pulse?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
{
"mcpServers": {
"orcatrace": {
"command": "npx",
"args": ["-y", "orcatrace-mcp"]
}
}
}You get get_index, get_pulse, get_digest_brief, get_sample, get_track_record.
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.
Claude Code:
claude mcp add orcatrace -- npx -y orcatrace-mcp
# with a wallet:
claude mcp add orcatrace --env PRIVATE_KEY=0x... -- npx -y orcatrace-mcpClaude Desktop / Cursor: add the JSON block above to your MCP config
(claude_desktop_config.json or .cursor/mcp.json).
Related MCP server: obolpay-x402-mcp
Tool | Endpoint | Description |
|
| Current feed index — poll target to detect new items (~10min cadence). |
|
| Top-3 24h repricings (noise-filtered) + a digest teaser — the free hook. |
|
| Digest teaser: title + summary, no analysis (full digest is |
|
| Static samples of every paid response shape (signal, whales, digest). |
|
| Verifiable whale-calibration scorecard: win rate, follow/fade ROI, per-odds-band breakdown, top-10 wallets with full public addresses. |
Tool | Endpoint | Price (USD) | Description |
|
| $0.01 | Most recent feed item — mover, whale entry (with calibration), or predetermined signal. |
|
| $0.01 | One feed item: quality-gated mover (+microstructure), named whale entry, or predetermined signal. Optional |
|
| $0.03 | Batch of up to 20 feed items. Optional |
|
| $0.02 | Markets resolving within |
|
| $0.05 | Historical digests (up to 7 days, 4h cadence). Optional |
|
| $0.05 | Whale calibration table: per-wallet win rates by odds band, mirror/fade ROI, follow/fade labels (min 30 resolved entries). |
|
| $0.10 | Full Polymarket Intelligence Digest (every 4h): what repriced and why across 42K markets — synthesized analysis. |
|
| $1.00 | Single-market deep-dive: 7-day price action + order book + whale positioning + news, synthesized into a thesis. Requires |
Prices are flat per call — no bundles, no entitlements. Confirm live prices any time via
the free get_sample / the site.
OrcaTrace speaks the x402 exact scheme. The API's 402 advertises a
Base (USDC, EIP-3009) rail; this MCP settles on Base:
The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with the accepted terms.
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.
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.
Variable | Required | Description |
| No | 0x-prefixed wallet key with USDC on Base Mainnet. Required to pay the 8 paid tools on a live API. Free tools work without it; without a key the paid tools surface the 402 price terms. |
| No | Override the API base URL (default |
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
MIT © jcislo
PAID $0.10 via x402. The full Polymarket Intelligence Digest (generated every 4h): what repriced and why across 42K markets — significant moves, whale positioning read through calibration, predetermined-outcome signals, and international news context. Synthesized analysis, not raw data. Never serves stale (returns 503, no charge, if generation falls behind). Free teaser: get_digest_brief. Pays USDC on Base via x402. Compute-first / settle-after — you are never charged for an error. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: no named parameters.
Polymarket Intelligence Digest teaser: title + summary, no analysis (GET /v1/digest/brief). The full digest is the paid get_digest tool ($0.10). FREE, rate-limited 5/min per IP, no wallet or API key required.
Inputs: no named parameters.
PAID $0.05 via x402. Historical Polymarket Intelligence Digests (up to 7 days, 4h cadence) — track how prediction-market narratives evolved. Example: hours=24, limit=6. Pays USDC on Base via x402. Compute-first / settle-after — you are never charged for an error. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: hours, limit.
Current Polymarket feed index — poll target to detect new items (cadence ~10min) before paying for a signal (GET /v1/index). FREE, rate-limited 5/min per IP, no wallet or API key required.
Inputs: no named parameters.
PAID $0.01 via x402. Most recent Polymarket feed item — a quality-gated mover, a tracked-whale entry (with hold-to-resolution calibration), or an AI-detected predetermined-outcome signal. Same shape as get_signal without an index. Poll get_index (free) first; preview the shape with get_sample (free). Pays USDC on Base via x402. Compute-first / settle-after — you are never charged for an error. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: no named parameters.
Top-3 Polymarket repricings over 24h (noise-filtered) plus a digest teaser — the free hook (GET /v1/pulse). FREE, rate-limited 5/min per IP, no wallet or API key required.
Inputs: no named parameters.
PAID $1.00 via x402. Single-market deep-dive: 7-day price action + live order book + tracked-whale positioning with calibration + related international news, synthesized into a thesis with risks and an actionable bottom line. Generated on demand (10-60s; cached 30 min). Pass the market slug from polymarket.com/market/ or from a feed item. Pays USDC on Base via x402. Settle-early with a guaranteed refund — if the API charges but cannot deliver, the payment is refunded. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: market (required).
PAID $0.02 via x402. Polymarket markets resolving within withinHours (1-72): odds, contested-vs-converged, liquidity, and order-book microstructure for the nearest expiries. Mechanical short-interval markets are excluded by default (set includeNoise=true to include them). Pays USDC on Base via x402. Settle-early with a guaranteed refund — if the API charges but cannot deliver, the payment is refunded. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: withinHours, includeNoise, minLiquidity.
Static samples of every paid Polymarket response shape (signal, whales, digest), explicitly labelled — use it to learn the contract before paying (GET /v1/sample). FREE, rate-limited 5/min per IP, no wallet or API key required.
Inputs: no named parameters.
PAID $0.01 via x402. One Polymarket feed item: a quality-gated mover (volume >= $10k & depth >= $2.5k, with order-book microstructure), a named whale entry (with calibration + microstructure), or a predetermined signal. Pass index=N for a specific item; omit for the latest. Pays USDC on Base via x402. Compute-first / settle-after — you are never charged for an error. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: index.
PAID $0.03 via x402. Batch of up to 20 Polymarket feed items: quality-gated movers with order-book microstructure, whale entries with calibration, and predetermined signals. Poll get_index (free), then pass since=N for new items; filter with type. Pays USDC on Base via x402. Compute-first / settle-after — you are never charged for an error. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: type, count, since.
Verifiable whale-calibration scorecard — the free proof behind the paid get_whales tool: aggregate hold-to-resolution win rate, follow/fade ROI, per-odds-band breakdown, and top-10 wallets with FULL public addresses so you can cross-check every claim on Polymarket (GET /v1/track-record). Measures entries held to resolution, not trader P&L — not financial advice. FREE, rate-limited 5/min per IP, no auth required.
Inputs: no named parameters.
PAID $0.05 via x402. Whale calibration table: per-wallet hold-to-resolution win rates by odds band, mirror/fade ROI, and follow/fade labels (minimum 30 resolved entries). This is the data behind the whale_entry annotations in the signal feed; the free proof is get_track_record. Pays USDC on Base via x402. Settle-early with a guaranteed refund — if the API charges but cannot deliver, the payment is refunded. Set PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 13 tools
Most tools are clearly distinct (get_index, get_sample, get_research, etc.), but get_latest and get_signal overlap significantly since get_signal can omit the index to return the latest item. get_track_record and get_whales are related but their descriptions clearly separate free proof from paid data.
All tools follow a consistent get_<noun> pattern with snake_case throughout. Plurals and modifiers (get_signals, get_digest_history) fit the convention and are predictable.
13 tools is well-scoped for a Polymarket intelligence API, covering free hooks, paid signals, digests, whale tracking, and research without over-expanding. Each tool has a clear role in the workflow.
The tool surface covers the core intelligence workflow: polling for new items, retrieving individual/batch signals, digest summaries and history, whale calibration, resolving markets, and on-demand research. Minor gaps exist (e.g., no simple market quote tool), but the domain is well-covered.
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
Paid market-data MCP: crypto, equities, smart-money, macro, wallet PnL. x402 per call on Base.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
