OrcaLayer MCP

● Active

io.github.orcalayer/orcalayer-mcp

Polymarket smart money and whale analytics: win rate, smart money flags, consensus, whale alerts

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "orcalayer-mcp": {
      "command": "uvx",
      "args": [
        "orcalayer-mcp"
      ],
      "env": {
        "ORCALAYER_API_KEY": "<your ORCALAYER_API_KEY>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env ORCALAYER_API_KEY='<your ORCALAYER_API_KEY>' --transport stdio orcalayer-mcp -- uvx orcalayer-mcp
OpenAI Codex CLI
codex mcp add orcalayer-mcp --env ORCALAYER_API_KEY='<your ORCALAYER_API_KEY>' -- uvx orcalayer-mcp
VS Code
code --add-mcp '{"name":"orcalayer-mcp","type":"stdio","command":"uvx","args":["orcalayer-mcp"],"env":{"ORCALAYER_API_KEY":"<your ORCALAYER_API_KEY>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • ORCALAYER_API_KEYsecretOptional Premium API key from orcalayer.com/pricing: adds the whale_alerts, pnl_leaderboard and resolution_events tools. Public tools work without it.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Crypto & Web3
Version
0.5.20
Registry
active
Published
11/20/2026

Live check

checked Nov 21, 2026, 02:07 UTC
● Working297 msprotocol 2025-06-18v0.5.20promptsresourcestools

The endpoint answered the MCP handshake as "orcalayer" and listed 5 tools. Answering since Nov 17, 2026.

Context cost ≈ 2.2k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 5 tools.

Tools (5)

tool list changed Nov 21, 2026, 02:07 UTC
  • leaderboard7 params

    Rank Polymarket traders from OrcaLayer's Smart Money set (or all wallets). Returns the top traders by lifetime profit, win rate, volume or trade count, optionally within one market category. Per wallet: name, total_pnl (Polymarket's lifetime P&L), market_win_rate with market_wins / market_losses / resolved_markets, profit_factor (capped at 99.99, with profit_factor_capped), indexed_volume_usd, indexed_trades, main category, average entry price, open positions and the last trade date. `total` is how many wallets match the filter. A `notes` block defines each field.

    Show parameters
    • sortstringRanking key: "pnl" (lifetime profit, default), "win_rate", "volume" or "trades". "win_rate" orders by the leaderboard's stored win rate, which is computed diffe
    • categoryRestrict to wallets mainly trading one category: "Crypto", "Politics", "Sports", "Esports", "Geopolitics", "Economics", "Tech/AI", "Culture" or "Weather" (case-
    • filterstring"smart" = OrcaLayer's Smart Money set (default); "all" = every ranked wallet.
    • limitintegerHow many wallets to return, 1 to 50 (larger values return 50).
    • under_radarbooleanTrue = only "Under the radar" wallets: top 10% for form against the price over the last 90 days but not in Smart Money (and not bots). They are outside Smart Mo
    • liquidity_providerbooleanTrue = only Liquidity providers: wallets Polymarket paid $100+ in liquidity rewards over the last 30 days, on 10+ days. Combines with `filter` and `under_radar`
    • habitOnly wallets with one trading habit over the last 90 days (recounted daily): "favorites" = Buys favorites (half or more of the money into outcomes bought at 90
  • wallet_overview1 param

    Summarize one wallet's trading profile and performance. Wallet profit tracking for any Polymarket address: lifetime P&L (Polymarket's figure), market_win_rate over resolved markets, a net profit factor, indexed volume and activity, category mix and leaderboard rankings. Accepts a 0x wallet address or an OrcaLayer nickname. Returns a compact summary rather than the full raw record, so it stays readable for heavy wallets. A `notes` block defines each field; market_win_rate has the same basis and value as in the leaderboard tool. While the wallet's stats are still being computed server-side, the result is a ``{"status": "computing", "retry_after_seconds": N}`` notice instead of data; N is the number of seconds after which the stats are expected to be ready.

    Show parameters
    • addressrequired0x wallet address (proxy or signer) or OrcaLayer nickname.
  • wallet_positions2 params

    List a wallet's largest open positions by current value. Accepts a 0x wallet address or an OrcaLayer nickname. Returns the positions with the largest current value first, in a compact form, plus a count of how many more are not shown.

    Show parameters
    • addressrequired0x wallet address (proxy or signer) or OrcaLayer nickname.
    • limitintegerHow many open positions to return, 1 to 50. The wallet may hold more; the response reports how many were left out.
  • markets5 params

    Search Polymarket markets, optionally where Smart Money wallets cluster. Finds markets by topic, slug or URL and shows how many wallets from OrcaLayer's Smart Money set hold each side right now. Returns each market's id, question, YES price, smart_wallets_yes / smart_wallets_no, volume, end date and days left. The counts are wallets, whatever their position size; the busiest markets count hundreds, a handful over a thousand. The dollar split on one market is in the market_consensus tool.

    Show parameters
    • qFree-text query; also accepts a Polymarket URL or slug. "" browses. Open markets only.
    • categoryRestrict to one market category: "Crypto", "Politics", "Sports", "Esports", "Geopolitics", "Economics", "Tech/AI", "Culture" or "Weather" (case-insensitive; "te
    • min_volumeMinimum market volume in USD. Omit for no minimum.
    • min_whalesMinimum number of Smart Money wallets holding a position in the market (either side). Omit for no minimum.
    • limitintegerHow many markets to return, 1 to 50 (larger values return 50).
  • market_consensus1 param

    Smart-money consensus on one Polymarket market versus its current price. Returns how Smart Money wallets are positioned on one market: how many hold YES and NO, how much capital each side has invested, the current market price, and the gap between that positioning and the price. Two consensus reads are returned side by side and can disagree: ``head_count`` (one Smart Money wallet = one vote; wallets from OrcaLayer's Smart Money set; the busiest markets count hundreds, a handful over a thousand; a wallet holding both sides is in both counts, while ``head_count.took_side`` counts each wallet once, on the side holding more of its dollars, as the OrcaLayer market page does) and ``capital_weighted`` (dollars invested per side). In head_count a $5 wallet weighs the same as a $500K one, so it is the weaker of the two reads; the capital split reflects the money at stake. On cheap longshots (YES under ~15 cents) head_count leans YES structurally. The divergence fields measure positioning against the price; they are not evidence that the price is wrong. An event slug or event URL (a Polymarket event groups several markets) returns the event's markets with their ids and Smart Money wallet counts instead, since the consensus is per market.

    Show parameters
    • marketrequiredMarket id, Polymarket market or event slug, polymarket.com URL, or 0x condition id.

Checked by Serverdex with a plain initialize + tools/list call to orcalayer.com/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 14, 2026
Stars
1
Forks
0
Last push
Nov 14, 2026
License
MIT

Python

From the README

orcalayer-mcp MCP server for the OrcaLayer Polymarket smart money and whale analytics API, inside Claude, Cursor and other MCP clients. OrcaLayer is an analytics layer on top of Polymarket's free Data API: the official API returns raw trades, positions and P&L, and OrcaLayer returns what you would otherwise compute from them: win rate per resolved market, smart money, farmer and bot flags, smart money consensus on each market, and whale alerts. What it adds over the official API. 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 eight read-only tools: Public tools work anonymously. whalealerts, pnlleaderboard and resolution_events need 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 ORCALAYERAPIKEY 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.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://orcalayer.com/mcp

Alternatives to OrcaLayer MCP

Best Crypto & Web3 servers →

The most-starred Crypto & Web3 servers in the index, with their live-check result.

ServerStarsLast pushLive check
Oh My Posh Validator23,757Nov 2026Working
Solana MCP by Vybe2,728Oct 2026Working
Solana MCP by Vybe2,728Oct 2026Working
Oracle3 prediction-market agent tools569Nov 2026Local / not checked
Flyto Core483Nov 2026Local / not checked

OrcaLayer MCP: questions people ask

Is OrcaLayer MCP a remote or a local MCP server?
According to its entry in the official MCP registry, OrcaLayer MCP ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (PyPI) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
Does OrcaLayer MCP need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 21, 2026. Individual tools may still ask for a key when called.
Is OrcaLayer MCP still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 14, 2026, 1 GitHub stars, MIT licence. Read from GitHub on Nov 14, 2026.
What tools does OrcaLayer MCP expose?
5 tools as listed by the server itself during the live check, including leaderboard, wallet_overview, wallet_positions, markets, market_consensus. The full list with parameters is in the Live check section above.
How do I add OrcaLayer MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Crypto & Web3 →

Add the badge to your site

Show visitors that OrcaLayer MCP is listed here — it’s also the link we check for a free listing.

OrcaLayer MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-orcalayer-orcalayer-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="OrcaLayer MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![OrcaLayer MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-orcalayer-orcalayer-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).