orcatrace-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PRIVATE_KEY | 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. | |
| ORCATRACE_API_URL | No | Override the API base URL (default https://api.orcatrace.dev). | https://api.orcatrace.dev |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_indexA | 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. |
| get_pulseA | 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. |
| get_digest_briefA | 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. |
| get_sampleA | 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. |
| get_track_recordA | 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. |
| get_latestA | 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. |
| get_signalA | 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. |
| get_signalsA | 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. |
| get_digestA | 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. |
| get_digest_historyA | 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. |
| get_resolvingA | 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. |
| get_whalesA | 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. |
| get_researchA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
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.