MCP server
Give Claude (or any MCP client) direct access to Polyrank with one config snippet.
@polyrank/mcp is a stdio Model Context Protocol
server exposing five read-only tools over the free public API — no
wallet, no key, no payment.
Install
Add to claude_desktop_config.json:
{
"mcpServers": {
"polyrank": {
"command": "npx",
"args": ["-y", "@polyrank/mcp"]
}
}
}claude mcp add polyrank -- npx -y @polyrank/mcpAdd to .cursor/mcp.json:
{
"mcpServers": {
"polyrank": {
"command": "npx",
"args": ["-y", "@polyrank/mcp"]
}
}
}Tools
| Tool | Input | Returns |
|---|---|---|
polyrank_get_leaderboard | preset? (default polyrank-default), limit? (≤25) | Top traders by composite skill |
polyrank_get_trader_skill | address (0x…) | Skill profile: rank, P&L, win rate, volume, percentiles |
polyrank_get_trader_calibration | address | 10-bin reliability diagram |
polyrank_get_market_consensus | market (conditionId or slug) | Smart-money consensus vs market mid + top holders |
polyrank_get_pulse | — | Live activity: big wins, sharp moves, trending, divergence |
All tools are annotated readOnlyHint — the server never writes anything.
Prompts that work well
- "Who are the 10 most calibrated traders on Polymarket right now?"
- "Is wallet 0x… skilled or just lucky? Check their calibration."
- "Where does smart money disagree with the market price today?"
Configuration
| Env var | Default | Purpose |
|---|---|---|
POLYRANK_API_BASE | https://api.polyrank.app | Point at a different API host |
Going deeper than the free tier
The MCP tools deliberately stop at commodity depth. For the full metric grid, smart-money tags, market positioning, and the signal stream, have your agent pay per request via the x402 Agent API — the two compose well: discover with MCP, verify with x402.