Metadata-Version: 2.4
Name: orcalayer-mcp
Version: 0.1.1
Summary: MCP server for the OrcaLayer API — Polymarket whale and market analytics for Claude Desktop and other MCP clients
Project-URL: Homepage, https://orcalayer.com
Project-URL: Documentation, https://orcalayer.com/docs
Project-URL: Repository, https://github.com/orcalayer/orcalayer-mcp
Author: OrcaLayer
License: MIT
License-File: LICENSE
Keywords: analytics,claude,mcp,model-context-protocol,polymarket,prediction-markets,whales
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Requires-Dist: mcp<2,>=1.27
Requires-Dist: orcalayer>=0.1.3
Description-Content-Type: text/markdown

# orcalayer-mcp

Model Context Protocol (MCP) server for the [OrcaLayer API](https://orcalayer.com) —
Polymarket whale and market analytics inside Claude Desktop and other MCP clients.

It is a thin stdio wrapper over the [`orcalayer`](https://pypi.org/project/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](https://orcalayer.com/pricing)) supplied via the
`ORCALAYER_API_KEY` environment variable.

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

```json
{
  "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](https://orcalayer.com/pricing)):

```json
{
  "mcpServers": {
    "orcalayer": {
      "command": "uvx",
      "args": ["orcalayer-mcp"],
      "env": { "ORCALAYER_API_KEY": "ol_your_key" }
    }
  }
}
```

Restart Claude Desktop after editing the config.

## License

MIT. See [LICENSE](LICENSE).

Data is provided for informational purposes only and is not financial advice.
