{"id":"io.github.polyrank/polyrank-mcp","slug":"io-github-polyrank-polyrank-mcp","title":"Polyrank","description":"Polymarket trader analytics for AI agents: rank wallets, read trader metrics, backtest strategies.","version":"0.5.1","publisher":{"kind":"github","id":"polyrank","label":"@polyrank on GitHub","url":"https://github.com/polyrank"},"website":"https://docs.polyrank.app/mcp","repository":"https://github.com/polyrank/PolyRank-MCP","remotes":[{"type":"streamable-http","url":"https://mcp.polyrank.app/mcp","headers":[{"description":"Optional. Your Polyrank API key as a bearer token (pk_live_…, from https://polyrank.app/api-keys). Without it the 17 free read-only tools work; the Ranking Builder, per-window trader metrics and the AI Lab tools need it (they also need a paid plan with the AI Lab; results are simulated).","value":"Bearer {api_key}","isSecret":true,"variables":{"api_key":{"description":"Your Polyrank API key (pk_live_…).","isRequired":true,"isSecret":true}},"name":"Authorization"}]}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@polyrank/mcp","version":"0.5.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Override the Polyrank API host (default https://api.polyrank.app).","name":"POLYRANK_API_BASE"},{"description":"Override the agent host whose free manifests (metric catalog, metric windows, Builder goals) are read (default https://api-agent.polyrank.app).","name":"POLYRANK_AGENT_BASE"},{"description":"Optional Polyrank API key (pk_live_…). Enables the authenticated tools: polyrank_rank_wallets (the Ranking Builder), polyrank_get_trader_metrics, the AI Lab tools and tid resolve. Anonymous tools work without it.","isSecret":true,"name":"POLYRANK_API_KEY"}]}],"published":"2026-11-14","updated":"2026-11-14","status":"online","auth":"","latency_ms":1205,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"polyrank_get_leaderboard","title":"Polyrank skill leaderboard","description":"Top 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.","read_only":true},{"name":"polyrank_get_trader_skill","title":"Polyrank trader skill profile","description":"A 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 volatility, the hold-time split, peak/avg capital-at-risk, copier-realized return, and the copy verdict — is gated to the ","read_only":true},{"name":"polyrank_get_trader_calibration","title":"Polyrank trader calibration","description":"A 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.","read_only":true},{"name":"polyrank_get_market_consensus","title":"Polyrank market consensus","description":"Skill-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.","read_only":true},{"name":"polyrank_get_pulse","title":"Polyrank live pulse","description":"Live 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 are the big and sharp wallets doing right now\".","read_only":true},{"name":"polyrank_get_platform_stats","title":"Polyrank platform coverage & metric count","description":"Live 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-11-21): the live source for \"N wallets / N metrics\" figures.","read_only":true},{"name":"polyrank_get_top_roi_trades","title":"Polyrank highest-ROI resolved trades","description":"The 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).","read_only":true},{"name":"polyrank_get_movers","title":"Polyrank skill-rank movers","description":"Traders whose skill rank climbed or fell the most recently (leaderboard momentum). Returns top climbers and fallers for a ranking preset over a lookback window.","read_only":true},{"name":"polyrank_get_smart_money_reports","title":"Polyrank Skill Report archive","description":"The 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.","read_only":true},{"name":"polyrank_get_smart_money_report","title":"Polyrank Skill Report (one week)","description":"One 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.","read_only":true},{"name":"polyrank_get_trader_by_tid","title":"Polyrank trader teaser (by masked id)","description":"Look 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 requires signing in on polyrank.app.","read_only":true},{"name":"polyrank_get_trader_calibration_by_tid","title":"Polyrank trader calibration (by masked id)","description":"A 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 discovery → tid → calibration loop without needing the raw wallet. Returns bins + total resolved count.","read_only":true},{"name":"polyrank_get_custom_ranking","title":"Polyrank published Builder ranking","description":"A 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/filter definition. Pass the slug from a shared /r/<slug> link.","read_only":true},{"name":"polyrank_get_traders_batch","title":"Polyrank trader teasers (batch, by masked id)","description":"Fetch 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 an error field) rather than failing the whole batch.","read_only":true},{"name":"polyrank_get_metrics_catalog","title":"Polyrank metric catalog (every rankable metric)","description":"The 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 the weights, skill_gates and metric_filters of polyrank_rank_wallets. Free, no key.","read_only":true},{"name":"polyrank_get_metric_windows","title":"Polyrank metric windows + as_of coverage","description":"Which 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 each it refuses. The reference for ranking at a window or as_of. Free, no key.","read_only":true},{"name":"polyrank_list_ranking_templates","title":"Polyrank ranking templates (Builder goals + presets)","description":"The 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 `banner` is a measured caveat to show with the board. Free, no key.","read_only":true},{"name":"polyrank_resolve_tid","title":"Polyrank resolve masked id → wallet","description":"Resolve an opaque masked id (tid) to the underlying proxy wallet address. Then use the resolved wallet with polyrank_get_trader_skill / polyrank_get_trader_calibration. Needs a signed-in Polyrank account (any plan, Free included).","read_only":true},{"name":"polyrank_rank_wallets","title":"Polyrank Ranking Builder (custom composite ranking)","description":"Rank 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_score_14d) and entry-timing ids at lifetime. filters: min_trades, min_resolved, min_inband_n_30d (the in-band positions","read_only":true},{"name":"polyrank_get_trader_metrics","title":"Polyrank trader metrics at a window","description":"One 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 user row as boards do. Needs a signed-in Polyrank account on Pro Trader or higher (https://polyrank.app/pricing).","read_only":true},{"name":"polyrank_list_lab_templates","title":"Polyrank AI Lab templates","description":"The AI 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 a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyra","read_only":true},{"name":"polyrank_get_backtest","title":"Polyrank AI Lab: a backtest and its report","description":"A 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 a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyrank.app/pricing).","read_only":true},{"name":"polyrank_get_paper_run","title":"Polyrank AI Lab: a paper run","description":"A 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 a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyrank.app/pricing).","read_only":true},{"name":"polyrank_list_strategies","title":"Polyrank AI Lab: your strategies","description":"Your 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 a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, fr","read_only":true},{"name":"polyrank_get_strategy","title":"Polyrank AI Lab: one strategy","description":"One 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 a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyrank.app/pricing).","read_only":true},{"name":"polyrank_list_backtests","title":"Polyrank AI Lab: your backtests","description":"Your recent backtests (all, or one strategy's), newest first, with status and headline (SIMULATED). Read one in full with polyrank_get_backtest. Needs a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyrank.app/pricing).","read_only":true},{"name":"polyrank_get_lab_limits","title":"Polyrank AI Lab: your plan limits and use","description":"Your plan's AI Lab limits and what is used now: backtests a day and today's, backtests waiting, paper runs at once, saved strategies, the assistant chats answering at once (lab_agent_concurrent) against those answering now, and the AI credits: credits_balance (allowance left + top-ups), credits_used_today, daily_ceiling_credits (null: none), when the allowance resets, what a typical question costs","read_only":true},{"name":"polyrank_lab_list_chats","title":"Polyrank AI Lab assistant: your chats","description":"Your AI Lab assistant chats, most recent first (at most 100): id, title, status (idle / queued / working / failed). Read one with polyrank_lab_get_chat. Needs a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyrank.app/pricing).","read_only":true},{"name":"polyrank_lab_get_chat","title":"Polyrank AI Lab assistant: one chat","description":"One of your AI 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 assistant started whose result will be posted to the chat by itself. Backtest and paper figures are SIMULATED. Needs a si","read_only":true},{"name":"polyrank_create_strategy","title":"Polyrank AI Lab: save a strategy","description":"Writes to the user's AI Lab: ask the user before calling, then pass confirm: true. Save a strategy to your AI 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 answers with the reason when it refuses","read_only":false},{"name":"polyrank_run_backtest","title":"Polyrank AI Lab: run a backtest","description":"Uses one of the plan's daily backtests: ask the user before calling, then pass confirm: true. Queue 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 measured optimism). Counts agains","read_only":false},{"name":"polyrank_start_paper","title":"Polyrank AI Lab: start paper trading","description":"Writes to the user's AI Lab: ask the user before calling, then pass confirm: true. Start 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). The run lasts 10 days unless run_days says otherwise (a whole number of days, 1 to 90, only when the user asked for that length; null = no end, it runs until stopped). T","read_only":false},{"name":"polyrank_update_strategy","title":"Polyrank AI Lab: edit a strategy","description":"Writes to the user's AI Lab: ask the user before calling, then pass confirm: true. Rename 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 a signed-in Polyrank account on a plan with the AI Lab (every paid plan, from Pro Tra","read_only":false},{"name":"polyrank_lab_ask","title":"Polyrank AI Lab assistant: ask in a new chat","description":"Spends the account's AI credits: ask the user before calling, then pass confirm: true. Start an AI 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, more thorough mode, about t","read_only":false},{"name":"polyrank_lab_reply","title":"Polyrank AI Lab assistant: reply in a chat","description":"Spends the account's AI credits: ask the user before calling, then pass confirm: true. Send the next message in one of your AI 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 a signed-in Polyrank account on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyrank.app/pricing).","read_only":false},{"name":"polyrank_lab_stop","title":"Polyrank AI Lab assistant: stop an answer","description":"Stop the AI 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 a signed-in Polyrank account. Strategies, backtests, paper runs and chats exist only on a plan with the AI Lab (every paid plan, from Pro Trader: https://polyrank.app/pricing).","read_only":false}],"server_info":{"name":"polyrank","version":"0.5.2"},"category":"analytics","tags":["crypto","agents","communication"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-07","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-polyrank-polyrank-mcp/"}