{
  "markdown": "# orcalayer-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/orcalayer-mcp.svg)](https://pypi.org/project/orcalayer-mcp/)\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)\n[![MCP Badge](https://lobehub.com/badge/mcp/orcalayer-orcalayer-mcp)](https://lobehub.com/mcp/orcalayer-orcalayer-mcp)\n[![Glama MCP](https://glama.ai/mcp/servers/orcalayer/orcalayer-mcp/badges/score.svg)](https://glama.ai/mcp/servers/orcalayer/orcalayer-mcp)\n[![orcalayer-mcp MCP server](https://glama.ai/mcp/servers/orcalayer/orcalayer-mcp/badges/card.svg)](https://glama.ai/mcp/servers/orcalayer/orcalayer-mcp)\n\nModel Context Protocol (MCP) server for the [OrcaLayer API](https://orcalayer.com) —\nPolymarket whale and market analytics inside Claude Desktop and other MCP clients.\n\nIt is a thin stdio wrapper over the [`orcalayer`](https://pypi.org/project/orcalayer/)\nPython SDK and exposes six tools:\n\n| Tool | What it does | Key |\n|---|---|---|\n| `leaderboard` | Rank smart-money whales by P&L, win rate or volume | No |\n| `wallet_overview` | Wallet profit tracking: profile, P&L and win-rate summary | No |\n| `wallet_positions` | A wallet's largest open positions | No |\n| `markets` | Track smart money flows: search markets where smart whales are accumulating | No |\n| `market_consensus` | Smart-money consensus on one market vs its price (head-count + capital-weighted) | No |\n| `whale_alerts` | Real-time alerts on profitable wallets: live feed of smart-whale trades | Premium |\n\nPublic tools work anonymously. `whale_alerts` needs a Premium API key\n([get one](https://orcalayer.com/pricing)) supplied via the\n`ORCALAYER_API_KEY` environment variable.\n\n> **New (2026-07-22):** the Premium SSE stream (`/api/public/v1/live/trades`)\n> now carries `settlement_type` (`MINT` / `MERGE` / `COMPLEMENTARY` / `null`)\n> on every event — live-derived settlement mechanics, shadow-verified\n> **100.000% accurate on MINT/MERGE**. It describes how the match settled,\n> **not trader intent** (~80% of all fills settle as MINT; `null` = honest\n> refusal, not \"not a mint\"). Details: the `orcalayer://api-reference`\n> resource or [orcalayer.com/docs/api](https://orcalayer.com/docs/api).\n\n## Prompts\n\nReady-to-use prompts for common analytics scenarios:\n\n| Prompt | What it does |\n|---|---|\n| `analyze_wallet` | Full wallet analysis — smart money or farmer? |\n| `find_divergence` | Markets where smart money disagrees with the current price |\n| `hedge_check` | Whether a wallet's profit was real alpha or a hedge structure |\n| `territorial_markets_review` | Ukraine territorial markets with ISW frontline overlay |\n\nIn Claude Desktop, pick a prompt from the prompt menu (the `+` / slash-command\npicker) — each one orchestrates the tools above for you.\n\n## Resources\n\nRead-only context the model can pull directly — no tool call needed:\n\n| Resource URI | Content |\n|---|---|\n| `orcalayer://methodology` | How smart money is filtered from farmers, hedgers and market-makers |\n| `orcalayer://glossary` | Prediction-markets glossary |\n| `orcalayer://api-reference` | OrcaLayer REST API reference (endpoints, auth, rate limits) |\n\n## Use with Claude Desktop\n\nAdd this to your `claude_desktop_config.json`\n(`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows,\n`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"orcalayer\": {\n      \"command\": \"uvx\",\n      \"args\": [\"orcalayer-mcp\"]\n    }\n  }\n}\n```\n\nThe public tools work as-is. For the Premium `whale_alerts` tool, add your\nAPI key ([get one](https://orcalayer.com/pricing)):\n\n```json\n{\n  \"mcpServers\": {\n    \"orcalayer\": {\n      \"command\": \"uvx\",\n      \"args\": [\"orcalayer-mcp\"],\n      \"env\": { \"ORCALAYER_API_KEY\": \"sk_orca_your_key_here\" }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after editing the config.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n\nData is provided for informational purposes only and is not financial advice.\n\n---\n\nmcp-name: io.github.orcalayer/orcalayer-mcp\n",
  "bytes": 4072,
  "sha": "6a7392538ae6d02fb149fa262b1a91f9758bc0696f0b53bb71f33ba11a347e52",
  "repo_slug": "orcalayer/orcalayer-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_orcalayer_orcalayer_mcp_bde7a36c/readme"
}