orcalayer/orcalayer-mcp

Model Context Protocol (MCP) server for the OrcaLayer API —
Polymarket whale and market analytics inside Claude, Cursor and other MCP clients.
Two ways to use it:
- **Hosted, nothing to install:** https://orcalayer.com/mcp (Streamable HTTP).
Add it as a connector in Claude (Settings → Connectors → Add custom connector,
paste the URL) or in any client that supports remote MCP servers.
- **Local (stdio):** uvx orcalayer-mcp, for Claude Desktop and other local clients.
Either way it is a thin wrapper over the orcalayer
Python SDK and exposes six read-only tools:
| Tool | What it does | Key |
|---|---|---|
| leaderboard | Rank wallets from the Smart Money set by P&L, win rate, volume or trade count | No |
| wallet_overview | Wallet profit tracking: profile, P&L, market win rate, profit factor, rankings | No |
| wallet_positions | A wallet's largest open positions | No |
| markets | Track smart money flows: search markets and see how many Smart Money wallets hold each side | No |
| market_consensus | Smart-money consensus on one market vs its price (head-count + capital-weighted) | No |
| whale_alerts | Real-time alerts on profitable wallets: live feed of smart-whale trades | Premium |
Public tools work anonymously. whale_alerts needs a Premium API key
(get one): on the hosted server send it as the
Authorization: Bearer request header (clients that support request
headers for a connector), on the local server set the ORCALAYER_API_KEY
environment variable. Without a key the tool answers with a short notice, not
an error.
Every tool carries readOnlyHint: true: nothing is created, changed or
deleted on your behalf. Data is read from the OrcaLayer API only.
Each result carries a short notes block that defines its fields, so a model
comparing two tools never meets two different numbers under one name:
market_win_rate (share of resolved markets won) has the same basis in
leaderboard and wallet_overview; profit_factor is capped at 99.99 on the
leaderboard (profit_factor_capped) and uncapped net in the overview;
indexed_volume_usd is the volume of fills in OrcaLayer's index, not
Polymarket's figure; Smart Money counts are wallets, whatever their size.
> **New (2026-07-22):** the Premium SSE stream (/api/public/v1/live/trades)
> now carries settlement_type (MINT / MERGE / COMPLEMENTARY / null)
> on every event — live-derived settlement mechanics, shadow-verified
> **100.000% accurate on MINT/MERGE**. It describes how the match settled,
> **not trader intent** (~80% of all fills settle as MINT; null = honest
> refusal, not "not a mint"). Details: the orcalayer://api-reference
> resource or orcalayer.com/docs/api.
Prompts
Ready-to-use prompts for common analytics scenarios:
| Prompt | What it does |
|---|---|
| analyze_wallet | Full wallet analysis — smart money or farmer? |
| find_divergence | Markets where smart money disagrees with the current price |
| hedge_check | Whether a wallet's profit was real alpha or a hedge structure |
| territorial_markets_review | Ukraine territorial markets with ISW frontline overlay |