orcalayer/orcalayer-mcp
🐍 ☁️ - Polymarket whale tracking & smart-money analytics. Filtered leaderboard (airdrop-farmers excluded), hedge detection, NegRisk correction, and Ukraine territorial markets with ISW frontline overlay.
Quick Install
{
"mcpServers": {
"orcalayer-orcalayer-mcp": {
"command": "npx",
"args": [
"-y",
"orcalayer-orcalayer-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
orcalayer-mcp
Model Context Protocol (MCP) server for the OrcaLayer API — Polymarket whale and market analytics inside Claude Desktop and other MCP clients.
It is a thin stdio wrapper over the orcalayer
Python SDK and exposes five tools:
| Tool | What it does | Key |
|---|---|---|
leaderboard | Rank smart-money whales by P&L, win rate or volume | No |
wallet_overview | A wallet's profile and performance summary | No |
wallet_positions | A wallet's largest open positions | No |
markets | Search markets where smart whales are clustering | No |
whale_alerts | Live feed of recent smart-whale trades | Premium |
Public tools work anonymously. whale_alerts needs a Premium API key
(get one) supplied via the
ORCALAYER_API_KEY environment variable.
New (2026-07-22): the Premium SSE stream (
/api/public/v1/live/trades) now carriessettlement_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: theorcalayer://api-referenceresource 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 |
In Claude Desktop, pick a prompt from the prompt menu (the + / slash-command
picker) — each one orchestrates the tools above for you.
Resources
Read-only context the model can pull directly — no tool call needed:
| Resource URI | Content |
|---|---|
orcalayer://methodology | How smart money is filtered from farmers, hedgers and market-makers |
orcalayer://glossary | Prediction-markets glossary |
orcalayer://api-reference | OrcaLayer REST API reference (endpoints, auth, rate limits) |
Use with Claude Desktop
Add this to your claude_desktop_config.json
(%APPDATA%\Claude\claude_desktop_config.json on Windows,
~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"orcalayer": {
"command": "uvx",
"args": ["orcalayer-mcp"]
}
}
}
The public tools work as-is. For the Premium whale_alerts tool, add your
API key (get one):
{
"mcpServers": {
"orcalayer": {
"command": "uvx",
"args": ["orcalayer-mcp"],
"env": { "ORCALAYER_API_KEY": "sk_orca_your_key_here" }
}
}
}
Restart Claude Desktop after editing the config.
License
MIT. See LICENSE.
Data is provided for informational purposes only and is not financial advice.