MCP server

Give Claude (or any MCP client) direct access to Polyrank with one config snippet.

@polyrank/mcp (v0.2.0) is a stdio Model Context Protocol server exposing eleven read-only tools over the free public API — no wallet, no key, no payment. Every tool is annotated readOnlyHint; the server never writes anything.

Install

claude mcp add polyrank -- npx -y @polyrank/mcp

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "polyrank": {
      "command": "npx",
      "args": ["-y", "@polyrank/mcp"]
    }
  }
}

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "polyrank": {
      "command": "npx",
      "args": ["-y", "@polyrank/mcp"]
    }
  }
}

Or use the one-click deep link: Add polyrank to Cursor

code --add-mcp '{"name":"polyrank","command":"npx","args":["-y","@polyrank/mcp"]}'

Or add to .vscode/mcp.json:

{
  "servers": {
    "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: rank, score, identity, P&L, win rate, volume
`polyrank_get_trader_skill`	`address` (0x…)	Skill profile: rank, P&L, win rate, volume, trades/markets, commodity percentiles
`polyrank_get_trader_calibration`	`address`	10-bin reliability diagram (predicted probability vs observed outcome)
`polyrank_get_market_consensus`	`market` (conditionId or slug)	Smart-money consensus vs. market mid, 24h volume/fills, positioner counts, top holders
`polyrank_get_pulse`	—	Live activity: big wins just banked, sharp moves, biggest recent trades, trending markets, consensus divergence
`polyrank_get_platform_stats`	—	Coverage + canonical metric count: wallets, trades, markets, skill-metric count, earliest data year
`polyrank_get_top_roi_trades`	`limit?` (≤100), `category?`, `since_days?`, `sort?`, `dir?`	Highest-ROI resolved trades (masked identities) — a hall of fame by ROI multiple
`polyrank_get_movers`	`preset?`, `lookback_days?` (≤30), `limit?` (≤10)	Skill-rank climbers and fallers over a lookback window
`polyrank_get_smart_money_reports`	`limit?` (≤104)	Archive of weekly Smart-Money Reports (ids/weeks + summaries)
`polyrank_get_smart_money_report`	`week` (e.g. `2026-w26`)	One weekly Smart-Money Report in full: big wins, movers, new entrants, calibration leader, divergence
`polyrank_get_trader_by_tid`	`tid` (masked id)	Trader teaser by the opaque masked id returned in leaderboard/pulse/movers/top-ROI rows

The deep layer — full Brier decomposition, alpha-vs-mid, smart-money tags, market positioning, copyability, and the live signal stream — is metered on the paid x402 Agent API; the MCP tools deliberately stop at commodity depth.

Prompts that work well

"Who are the 10 most calibrated traders on Polymarket right now?"
"Is wallet 0xf68A281980f8c13828e84e147e3822381d6e5B1B skilled or just lucky? Check their calibration." (a real top-0.5% wallet — try it)
"Where does smart money disagree with the market price today?"
"Show me this week's Polyrank Smart-Money Report."
"Which wallets climbed the skill leaderboard the most this week?"
"What are the highest-ROI resolved Sports trades on Polymarket?"

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.