Agent Data Tools: Prices and DeFi
50 tools: token prices, wallet and contract risk, liquidity pools, FX. 25 free calls.
Description from the maker (original English)
Polymarket trader analytics for AI agents: rank wallets, read trader metrics, backtest strategies.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
POLYRANK_API_BASE, POLYRANK_AGENT_BASE, POLYRANK_API_KEY, AuthorizationValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"polyrank": {
"command": "npx",
"args": [
"-y",
"@polyrank/mcp"
],
"env": {
"POLYRANK_API_BASE": "your-value",
"POLYRANK_AGENT_BASE": "your-value",
"POLYRANK_API_KEY": "your-value"
}
}
}
}Run this in your terminal
claude mcp add --transport http polyrank https://mcp.polyrank.app/mcp --header 'Authorization: Bearer {api_key}'claude mcp add polyrank --env POLYRANK_API_BASE=your-value --env POLYRANK_AGENT_BASE=your-value --env POLYRANK_API_KEY=your-value -- npx -y @polyrank/mcpFill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"polyrank": {
"url": "https://mcp.polyrank.app/mcp",
"headers": {
"Authorization": "Bearer {api_key}"
}
}
}
}Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"polyrank": {
"command": "npx",
"args": [
"-y",
"@polyrank/mcp"
],
"env": {
"POLYRANK_API_BASE": "your-value",
"POLYRANK_AGENT_BASE": "your-value",
"POLYRANK_API_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"polyrank": {
"type": "http",
"url": "https://mcp.polyrank.app/mcp",
"headers": {
"Authorization": "Bearer {api_key}"
}
}
}
}Paste into .vscode/mcp.json in your project
{
"servers": {
"polyrank": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@polyrank/mcp"
],
"env": {
"POLYRANK_API_BASE": "your-value",
"POLYRANK_AGENT_BASE": "your-value",
"POLYRANK_API_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.
Your choice stays on this device in a cookie; no account needed.
POLYRANK_API_BASE envPOLYRANK_AGENT_BASE envAuthorization secret HTTP headerThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.
polyrank_get_leaderboardTop Polymarket traders ranked by genuine SKILL (calibration/Brier, alpha-vs-mid, risk-adjusted return) — not vanity P&L or win rate. Returns rank, composite score, identity, P&L, win-rate, volume. Use it to find traders to study.
polyrank_get_trader_skillA single Polymarket wallet’s skill profile: composite rank, P&L, win-rate, volume, trades/markets, and commodity percentiles. The deep skill grid — full Brier decomposition, alpha-vs-mid, information coefficient, Sharpe, copyability & max copyable clip, true slippage, realized vo
polyrank_get_trader_calibrationA wallet’s 10-bin reliability diagram (predicted probability vs observed outcome rate). Calibration is the core skill signal — whether the trader’s probabilities match reality. Returns bins + total resolved count.
polyrank_get_market_consensusSkill-weighted holder consensus on a Polymarket market vs the market mid (the Polyrank-vs-mid delta), plus 24h volume/fills, positioner counts, and top holders. Accepts a conditionId (0x + 64 hex) or a market slug.
polyrank_get_pulseLive Polymarket activity: big wins just banked (realized profit), sharp-money moves, the biggest recent trades, trending markets by volume, and markets where Polyrank consensus diverges most from the market mid. Good for "what is smart money doing right now".
polyrank_get_platform_statsLive Polyrank coverage and the canonical skill-metric count: wallets scored (`wallets`), raw fill events indexed (`trades`), markets covered, the number of skill metrics in the catalog, and the earliest market year in the data (`since_year`; on-chain order-book fills start 2022-1
polyrank_get_top_roi_tradesThe biggest return-on-cost RESOLVED Polymarket bets (won positions with a real cost floor) — a hall-of-fame of single trades by ROI multiple. Optionally filter by market category (e.g. "Sports", "Politics", "Crypto"). Identities are masked (pseudonym only).
polyrank_get_moversTraders whose skill rank climbed or fell the most recently (leaderboard momentum). Returns top climbers and fallers for a ranking preset over a lookback window.
polyrank_get_smart_money_reportsThe archive of Polyrank weekly Skill Reports (published each week): a list of report ids/weeks with summaries. Fetch one in full with polyrank_get_smart_money_report.
polyrank_get_smart_money_reportOne Polyrank weekly Skill Report in full: big wins, skill-rank movers, new entrants, the calibration leader, consensus divergence, and the editorial intro. Pass the week/report id from polyrank_get_smart_money_reports.
polyrank_get_trader_by_tidLook up a trader by the opaque masked id (tid) returned in leaderboard / pulse / movers / top-ROI rows — those masked surfaces omit the raw wallet, so use the tid to follow a trader. Returns the same masked skill teaser as the wallet lookup. Full wallet/identity resolution requir
polyrank_get_trader_calibration_by_tidA trader’s 10-bin reliability diagram (predicted probability vs observed outcome rate) keyed by the opaque masked id (tid) from a leaderboard / pulse / movers / top-ROI row. Calibration is the core skill signal — whether the trader’s probabilities match reality. Completes the dis
polyrank_get_custom_rankingA published Polyrank Builder ranking: masked top-25 + the weight/filter definition. Builder rankings are custom skill leaderboards (a weighting over the metric catalog plus filters) that users publish and share by slug. Returns the masked top-25 rows and the ranking’s weight/filt
polyrank_get_traders_batchFetch the free masked skill teaser for several traders at once by their opaque masked ids (tids). Same per-trader payload as polyrank_get_trader_by_tid, capped at 10 tids per call. No API key needed. Each result is tagged with its tid, and per-tid failures are returned inline (as
polyrank_get_metrics_catalogThe full catalog of displayable Polyrank metrics (84): id, name, description, category, direction (higher/lower is better), the windows each is available at, and whether it is advanced. This is the vocabulary for polyrank_rank_wallets weights, skill_gates and metric_filters. Free
polyrank_get_metric_windowsWhich metric exists at which window (lifetime / 90d / 30d / 7d / 24h), whether it can be weighted, gated or filtered, the copy-engine and entry-timing ids (lifetime-pinned), and what a back-dated board (as_of) can answer: its metrics, the filters it honours and the reason for eac
polyrank_list_ranking_templatesThe Ranking Builder's goals (e.g. "Copy entries", "Copy engine") as the exact request the Builder runs for each, and the site's preset boards with their configs. Pass a goal's `request` (or a preset's config) to polyrank_rank_wallets to reproduce that board, or edit it. A goal `b
polyrank_resolve_tidResolve an opaque masked id (tid) to the underlying proxy wallet address. Requires a Polyrank API key (pk_live_… / pk_test_…): set POLYRANK_API_KEY. The MCP sends it as a Bearer token and the API key-auth accepts it — no browser session needed. Then use the resolved wallet with p
polyrank_rank_walletsRank every Polymarket wallet with your own composite — exactly what the Ranking Builder runs (POST /v1/rankings/custom). weights: metric id → weight (or {weight, window}); any of the 84 catalog metrics at any window it exists at (polyrank_get_metric_windows), plus copy-engine (sk
polyrank_get_trader_metricsOne trader's every metric displayable at a window (lifetime / 90d / 30d / 7d / 24h): the raw value and its percentile in that window's cohort — the cells a board ranked at that window scores. Give a wallet address or a masked tid. scope=combined (default) reads the multi-wallet u
polyrank_list_lab_templatesThe Strategy Lab's templates: research strategy families as editable strategy specs, each with its as-of evidence (SIMULATED, per $10 copied) and caveats. Copy one's `spec` (or its id) into polyrank_create_strategy / polyrank_run_backtest. Needs POLYRANK_API_KEY.
polyrank_get_backtestA backtest by id: its status (queued / running / done / failed) and, when done, the full SIMULATED report (per-$10 P&L, copies, the no-selection control, without-best-wallet, capacity, funnel, per wallet, daily). Needs POLYRANK_API_KEY.
polyrank_get_paper_runA paper run by id with the grader's stats (copies, resolved, P&L per $10, entry vs the leader, the paper gate) and its copies, each with its fate (copied / no_fill / leader_sold / capped / skipped + reason). Needs POLYRANK_API_KEY.
polyrank_list_strategiesYour saved strategies, newest first, each with its state and its latest backtest's headline (per $10 copied, copies; SIMULATED). `status` lists only one state: draft, backtested (tested), paper (paper trading), promotable (passed the paper gate), live, archived. Needs POLYRANK_AP
polyrank_get_strategyOne of your strategies by id: its name, state and full strategy spec (wallet source, market, entry, sizing, exit). Edit it with polyrank_update_strategy. Needs POLYRANK_API_KEY.
polyrank_list_backtestsYour recent backtests (all, or one strategy's), newest first, with status and headline (SIMULATED). Read one in full with polyrank_get_backtest. Needs POLYRANK_API_KEY.
polyrank_get_lab_limitsYour plan's Strategy Lab limits and what is used now: backtests a day and today's, backtests waiting, paper runs at once, saved strategies, and the assistant chats answering at once (lab_agent_concurrent) against those answering now. Needs POLYRANK_API_KEY.
polyrank_lab_list_chatsYour Lab assistant chats, most recent first (at most 100): id, title, status (idle / queued / working / failed). Read one with polyrank_lab_get_chat. Needs POLYRANK_API_KEY (a paid plan; the assistant is part of every paid plan).
polyrank_lab_get_chatOne of your Lab assistant chats: its status, the questions and the assistant's answers with their notices and result cards (backtests, shortlists, strategies, tables). While a question waits, `queue_position` says how many are ahead; `awaiting_backtests` counts backtests the assi
polyrank_create_strategySave a strategy to your Lab: a name plus a strategy spec (wallet source — any Builder ranking, a history ranking, a static wallet list or a copy-engine sleeve — and market, entry, sizing and exit rules), or a template_id to copy a template. The server validates the spec and answe
polyrank_run_backtestQueue a backtest of a saved strategy (strategy_id) or an unsaved spec over [from, to) (ISO dates, at most 366 days), optionally with explicit re-rank cuts. Answers with the queued run; poll polyrank_get_backtest. Results are SIMULATED (each report names its fill model and measure
polyrank_start_paperStart paper trading a saved strategy: from now on every signal of its wallets is scored against the real order book (no orders, no keys, no money). One active run per strategy. Needs POLYRANK_API_KEY (plan feature paper_trading).
polyrank_update_strategyRename a saved strategy and/or replace its strategy spec (a changed spec makes it a draft again: its earlier backtests stay, tested on the old rules). The server validates the spec and answers with the reason when it refuses. Needs POLYRANK_API_KEY.
polyrank_lab_askStart a Lab assistant chat with a question (research only: it finds traders, saves, backtests and paper-trades strategies in YOUR account, never places orders). Spends your plan's AI credits (a question needs 25 to start; a typical one costs about 13; `deep: true` runs the slower
polyrank_lab_replySend the next message in one of your Lab assistant chats (409 while it is still answering). Spends AI credits like polyrank_lab_ask and waits the same way for the answer. Needs POLYRANK_API_KEY.
polyrank_lab_stopStop the Lab assistant answering in one of your chats: a question still queued is withdrawn; a running answer stops within about a second and keeps what it finished. A backtest it started keeps running. Needs POLYRANK_API_KEY.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026
The registry name was verified with the GitHub account polyrank, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Responded in 454 ms (HTTP 200)
No sign-in needed
Read 36 tool descriptions and found no hidden instructions to the AI
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: POLYRANK_API_KEY, Authorization
Either way works: install it on your computer or connect to the cloud version.
The GitHub repo last changed –, and the latest version (0.5.0) reached the registry today.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
In the same category: Agent Data Tools: Prices and DeFi, Agent Data Tools: Chain data, Bellchain
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
50 tools: token prices, wallet and contract risk, liquidity pools, FX. 25 free calls.
360 tools: balances, blocks, gas, txs and logs on 5 EVM chains, plus Bitcoin. 25 free calls.
Crypto alert chains in your AI assistant: check alerts, test ideas with the replay, build chains.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
MCP server that gives AI agents (Claude, etc.) direct access to Polyrank — the skill-analytics layer for Polymarket. It ranks millions of Polymarket wallets by genuine forecasting skill (calibration / Brier, alpha-vs-mid, risk-adjusted return) — not vanity P&L or win rate. _Follow the skilled, not the lucky._ (Live coverage + the exact skill-metric count: polyrank_get_platform_stats.)
The public tools wrap Polyrank's free API — no key. With a Polyrank API key (POLYRANK_API_KEY, from polyrank.app/api-keys on a plan with the Ranking Builder / Strategy Lab), the ranking, trader-metrics and Strategy Lab tools call the authenticated API: the same `POST /v1/rankings/custom` the Ranking Builder runs — any of the 84 metrics at any window it exists at, every filter, as_of boards — plus per-window trader metrics and backtests / paper trading. Agents that pay per call instead of holding a key use the x402 agent API — see https://polyrank.app/llms.txt.
Every tool carries a title and the MCP annotations readOnlyHint, destructiveHint, idempotentHint and openWorldHint: 29 tools are read-only; the 7 Strategy Lab writes (polyrank_create_strategy, polyrank_run_backtest, polyrank_start_paper, polyrank_update_strategy, polyrank_lab_ask, polyrank_lab_reply, polyrank_lab_stop) each create or change a record in your own Polyrank account and are marked destructiveHint: false (none deletes anything, none touches funds; the chat tools spend your plan's AI credits). Read-only tools are listed first.
| Tool | What it does |
|---|---|
polyrank_get_leaderboard | Top traders ranked by composite skill |
polyrank_get_trader_skill | A wallet's P&L / win-rate / volume / percentiles |
polyrank_get_trader_calibration | A wallet's 10-bin reliability diagram |
polyrank_get_market_consensus | Skill-weighted holder consensus vs market mid + top holders |
polyrank_get_pulse | Live activity: big wins, sharp moves, trending, divergence |
polyrank_get_platform_stats | Live coverage + skill-metric count (wallets/trades/markets) |
polyrank_get_top_roi_trades | Biggest return-on-cost resolved trades (filter by category) |
polyrank_get_movers | Traders climbing / falling fastest in skill rank |
polyrank_get_smart_money_reports | Weekly Skill Report archive |
polyrank_get_smart_money_report | One weekly Skill Report in full |
polyrank_get_trader_by_tid | Follow a masked trader by its tid |
polyrank_get_trader_calibration_by_tid | A masked trader's 10-bin reliability diagram by tid |
polyrank_get_custom_ranking | A published Builder ranking: masked top-25 + weight/filter def |
polyrank_get_traders_batch | Masked teasers for up to 10 tids in one call |
polyrank_get_metrics_catalog | The 84 rankable metrics: id, meaning, direction, windows |
polyrank_get_metric_windows | Which metric exists at which window; what as_of can answer |
polyrank_list_ranking_templates | The Builder's goals ("Copy entries", …) as ready requests + presets |
POLYRANK_API_KEY) — 3| Tool | What it does |
|---|---|
polyrank_resolve_tid | Resolve a masked tid → wallet |
polyrank_rank_wallets | The Ranking Builder: weights × windows × filters, as_of, explain, any sort |
polyrank_get_trader_metrics | One trader's every metric at a window: value + percentile (address or tid) |
POLYRANK_API_KEY on a paid plan with the Lab; results are SIMULATED) — 16| Tool | What it does |
|---|---|
polyrank_list_lab_templates | Strategy templates (editable specs) with their as-of evidence |
polyrank_create_strategy | Save a strategy (spec or template) |
polyrank_run_backtest | Queue a backtest of a strategy or spec over a date range |
polyrank_get_backtest | A backtest's status and report |
polyrank_start_paper | Start paper trading a strategy against real order books (no money) |
polyrank_get_paper_run | A paper run's stats and its copies |
polyrank_list_strategies | Your strategies, filtered by state (draft, tested, paper…) |
polyrank_get_strategy | One strategy with its full spec |
polyrank_list_backtests | Your recent backtests, all or one strategy's |
polyrank_get_lab_limits | Your plan's Lab limits and what is used, incl. chats at once |
polyrank_lab_list_chats | Your Lab assistant chats |
polyrank_lab_get_chat | One chat: answers, result cards, queue position |
polyrank_update_strategy | Rename a strategy or replace its spec |
polyrank_lab_ask | Ask the Lab assistant in a new chat (spends AI credits) |
polyrank_lab_reply | Reply in a chat (spends AI credits) |
polyrank_lab_stop | Stop an answer |
The Strategy Lab tools act as your own Polyrank account: a plan with the Lab (Pro Trader and up; a strategy that copies no wallet needs Lab Pro and up), each backtest counting against the plan's backtests a day, with queue_position and eta_s on a queued run. Plans and limits: https://docs.polyrank.app/lab.
The Lab assistant (polyrank_lab_ask, polyrank_lab_reply): the same assistant as polyrank.app/lab, acting in your account (research only; it never places orders). Each question spends your plan's AI credits (25 needed to start, a typical one about 13; deep: true about twice) and your plan answers a number of chats at once (Pro Trader 2, Lab Pro 3, Quant 4, Quant Max 6, Desk 6, Enterprise 8; one more answers 429 lab_agent_busy). The tool waits up to wait_seconds (default 45, at most 55) for the answer, then returns what is there; poll polyrank_lab_get_chat while next says it is still answering. A backtest the assistant starts that takes longer than a few seconds runs on: awaiting_backtests counts them, and each result is posted to the chat when it finishes. Every answer, and every Lab result with simulated figures (polyrank_run_backtest, polyrank_get_backtest, polyrank_get_paper_run, polyrank_list_strategies, polyrank_list_backtests), comes with the CFTC Rule 4.41 statement (simulated_results_notice).
Reproduce a Builder board (e.g. "Copy entries", top 20): call polyrank_list_ranking_templates, then polyrank_rank_wallets with that goal's request.
Claude Code
claude mcp add polyrank -- npx -y @polyrank/mcp
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": { "polyrank": { "command": "npx", "args": ["-y", "@polyrank/mcp"] } } }
Cursor — add to .cursor/mcp.json (same block as above), or use the one-click deep link:
VS Code
code --add-mcp '{"name":"polyrank","command":"npx","args":["-y","@polyrank/mcp"]}'
Config: POLYRANK_API_BASE (default https://api.polyrank.app), POLYRANK_AGENT_BASE (default https://api-agent.polyrank.app; only its free manifests are read), and optional POLYRANK_API_KEY, which unlocks the ranking, trader-metrics, Strategy Lab and tid-resolve tools. With a key:
claude mcp add polyrank -e POLYRANK_API_KEY=pk_live_… -- npx -y @polyrank/mcp
Polyrank hosts this server at `https://mcp.polyrank.app` (Streamable HTTP), so nothing needs installing:
| Endpoint | Tools |
|---|---|
POST https://mcp.polyrank.app/mcp | all 36. The 17 free tools work with no header; the other 19 need Authorization: Bearer pk_live_… (your own key, your plan's limits) and otherwise answer that they need a key |
POST https://mcp.polyrank.app/mcp/public | the 17 free read-only tools only; any Authorization header is ignored |
GET https://mcp.polyrank.app/healthz | status and version |
claude mcp add --transport http polyrank https://mcp.polyrank.app/mcp --header "Authorization: Bearer pk_live_…"
claude mcp add --transport http polyrank-free https://mcp.polyrank.app/mcp/public
It is for MCP clients and agent backends, not for pages in a browser: a request that carries a browser Origin header is refused (403). Limits: 100 requests a minute per address without a key, 600 a minute with a key, and your plan's API limits behind them. The 6 Strategy Lab tools need a paid plan with the Lab; their results are simulated.
The package also runs this server itself (MCP_HTTP_ENABLED=1); with no flag it is the stdio server above.
Run it yourself: MCP_HTTP_ENABLED=1 MCP_HTTP_PORT=3005 npx -y @polyrank/mcp, then curl -s localhost:3005/healthz. Options (env): MCP_HTTP_HOST (default 127.0.0.1), MCP_HTTP_PORT (3005), MCP_HTTP_ALLOWED_HOSTS (Host header allow-list, default mcp.polyrank.app,localhost,127.0.0.1,[::1]), MCP_HTTP_ALLOWED_ORIGINS (browser Origin allow-list, default none), MCP_HTTP_ANON_PER_MIN (100), MCP_HTTP_KEY_PER_MIN (600), MCP_HTTP_VERIFY_KEYS (1), MCP_HTTP_MAX_BODY_BYTES (1048576), MCP_FORWARD_CLIENT_IP (0). In HTTP mode POLYRANK_API_KEY is ignored: every caller sends their own key. Details: src/http.ts.
Not affiliated with Polymarket · not investment advice · not custodial.