Polyrankdocs

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/mcp

Add to .cursor/mcp.json:

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

Tools

ToolInputReturns
polyrank_get_leaderboardpreset? (default polyrank-default), limit? (≤25)Top traders by composite skill
polyrank_get_trader_skilladdress (0x…)Skill profile: rank, P&L, win rate, volume, percentiles
polyrank_get_trader_calibrationaddress10-bin reliability diagram
polyrank_get_market_consensusmarket (conditionId or slug)Smart-money consensus vs market mid + top holders
polyrank_get_pulseLive 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 varDefaultPurpose
POLYRANK_API_BASEhttps://api.polyrank.appPoint 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.

On this page