Model Context Protocol

The Polymarket MCP Server

Q: Is the Polymarket MCP server free?

You get a free API key instantly from the Telegram bot with /apikey, and a 7-day free trial with full access (card required to start, $0 today). After the trial, full data access is part of Polyvision Premium at $29/month.

Q: What are the rate limits?

Each API key gets a sliding-window per-minute budget. Limits apply identically to the REST API and the MCP HTTP transport — both share the same counter. The check_quota tool reports your usage without consuming quota.

Give Claude, Cursor, or any MCP-compatible agent direct access to Polymarket trader intelligence — wallet analysis, copy scores, leaderboards, and backtested strategies. One config block. No wallet connection, ever.

What your agent can do

The Model Context Protocol (MCP) is the open standard that lets AI assistants call external tools. Polyvision's MCP server exposes the same engine behind our Telegram bot — 82,000+ wallet analyses and counting — as 17 tools your agent can call in plain English:

"Analyze wallet 0x4bd0… — is it worth copying?" → full P&L, win rate, risk metrics, red flags, and a 0–10 copy score.
"Who are today's top 10 Polymarket traders?" → the daily leaderboard, ranked by copy score.
"Build me a conservative copy-trading plan." → backtested strategy profiles with expected win rate, ROI, Sharpe, and drawdown.

Quickstart

1. Get a free API key. Open @PolyVisionBot on Telegram and type /apikey — the bot replies instantly.

2. Add the server. In Claude Code, one command:

claude mcp add --transport http polyvision https://api.polyvisionx.com/mcp \
  --header "Authorization: Bearer $POLYVISION_API_KEY"

Or in Claude Desktop, Cursor, or Windsurf, add this to your MCP config (streamable HTTP):

{
  "mcpServers": {
    "polyvision": {
      "type": "streamable-http",
      "url": "https://api.polyvisionx.com/mcp",
      "headers": {
        "Authorization": "Bearer ${POLYVISION_API_KEY}"
      }
    }
  }
}

A local stdio transport is also available for self-hosted setups.

7-day free trial with full access — card required to start, $0 today. Premium or an active trial is needed for the data tools. Rate limits are shared with the REST API.

The 17 tools

Tool	What it does
analyze_wallet	Comprehensive wallet analysis — P&L, win rate, risk metrics, categories, copy score, red flags. Quick (~5s) or full (~30–60s) mode.
get_score	Compact 0–10 copy-trading score with recommendation, tier, key metrics, and red flags.
get_recent_trades	Recent trades for a wallet — side, size, price, market, timestamps.
get_leaderboard	Daily top-10 traders ranked by copy score.
discover_wallet	Random elite trader from a curated pool of 250+ wallets.
get_wallet_pool	Browse historically-vetted consistent traders; filter by category, sort by score/P&L/win rate.
get_hot_bets	Today's most profitable open positions from top traders.
get_strategy	Backtested copy-trading strategy profiles — conservative, moderate, aggressive.
get_portfolio	Your tracked wallet portfolio with nicknames, scores, and notification settings.
add_to_portfolio	Track a wallet, with an optional nickname.
remove_from_portfolio	Stop tracking a wallet.
calculate	Deterministic position-sizing, ROI, and payout math — safe arithmetic only.
get_knowledge	Polyvision's copy-trading methodology — scoring tiers, sizing, red flags.
check_quota	Usage stats and current tier; doesn't consume quota.
health	System health check.
regenerate_key	Rotate your API key (old key invalidated).
deactivate_key	Permanently deactivate your key.

Prompts to try

"Pull the daily leaderboard, then run a full analysis on the top three traders and tell me which one fits a conservative copy strategy."

Chains get_leaderboard → analyze_wallet → get_strategy in one request.

"Watch for red flags: analyze 0x… and tell me if the win rate is inflated by redeems or if the P&L depends on a single lucky market."

The analysis breaks out true P&L, redeems, and concentration risk.

"Browse the sports category of the consistent-traders pool and size a $500 allocation across the two best wallets."

Combines get_wallet_pool with the calculate tool for sizing math.

Full endpoint reference, auth details, and the stdio transport live in the developer docs. The server is also listed on ClawHub. Want the same intelligence without any setup? The free copy list delivers our 10 highest-scoring wallets to your inbox.

Wire it up in two minutes

Grab a free API key from the Telegram bot, paste one config block, and your agent can vet any Polymarket trader on demand.

Get Your Free API Key

$0 today · 7-day full-access trial · cancel anytime

FAQ

What is the Polymarket MCP server?

It's Polyvision's Model Context Protocol server — a bridge that lets AI assistants like Claude, Cursor, and Windsurf call Polymarket wallet-analysis tools directly: P&L and risk analysis, 0–10 copy scores, the daily leaderboard, and backtested strategy profiles, all through natural language.

Does it place trades on Polymarket?

No. Every tool is read-only analysis. Polyvision never asks you to connect a crypto wallet and never executes trades — it reads public on-chain data and returns analysis. What you do with the insight is up to you.

Which AI clients does it work with?

Any MCP-compatible client. Claude Desktop, Claude Code, Cursor, and Windsurf all work with the streamable HTTP transport. A local stdio transport is available too.

Is it free?

The API key is free and instant via /apikey in the Telegram bot, with a 7-day full-access trial (card required, $0 today). After that, full data access is part of Polyvision Premium at $29/month.

What are the rate limits?

Each key gets a sliding-window per-minute budget, shared between the REST API and MCP transport. The check_quota tool reports usage without consuming quota.