Back to Browse

Orcalayer MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Polymarket smart-money analytics: whale leaderboard, wallet P&L, market consensus, live alerts

About

Polymarket smart-money analytics: whale leaderboard, wallet P&L, market consensus, live alerts

Security Report

5.2
Moderate5.2Moderate Risk

This is a well-structured MCP server for the OrcaLayer Polymarket analytics API. It properly handles authentication (optional for public tools, Premium API key via environment variable), implements defensive error handling with API key scrubbing, and delegates all business logic to an upstream SDK. Permissions are appropriate for the category (network_http, env_vars) and match the server's purpose. Minor issues include loose exception handling and absence of input validation on user-supplied market identifiers, but these are low-severity and do not create exploitable vulnerabilities. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

5 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Optional Premium API key from orcalayer.com/pricing (enables the whale_alerts tool). Public tools work without it.Required

Environment variable: ORCALAYER_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-orcalayer-orcalayer-mcp": {
      "env": {
        "ORCALAYER_API_KEY": "your-orcalayer-api-key-here"
      },
      "args": [
        "orcalayer-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

orcalayer-mcp

PyPI MIT License MCP MCP Badge Glama MCP orcalayer-mcp MCP server

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 six tools:

ToolWhat it doesKey
leaderboardRank smart-money whales by P&L, win rate or volumeNo
wallet_overviewWallet profit tracking: profile, P&L and win-rate summaryNo
wallet_positionsA wallet's largest open positionsNo
marketsTrack smart money flows: search markets where smart whales are accumulatingNo
market_consensusSmart-money consensus on one market vs its price (head-count + capital-weighted)No
whale_alertsReal-time alerts on profitable wallets: live feed of smart-whale tradesPremium

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 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:

PromptWhat it does
analyze_walletFull wallet analysis — smart money or farmer?
find_divergenceMarkets where smart money disagrees with the current price
hedge_checkWhether a wallet's profit was real alpha or a hedge structure
territorial_markets_reviewUkraine 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 URIContent
orcalayer://methodologyHow smart money is filtered from farmers, hedgers and market-makers
orcalayer://glossaryPrediction-markets glossary
orcalayer://api-referenceOrcaLayer 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.


mcp-name: io.github.orcalayer/orcalayer-mcp

Reviews

No reviews yet

Be the first to review this server!