Polymarket MCP Server — Live Prediction-Market Data for AI Agents

Give your AI agent live Polymarket data as native tools: search markets, pull real-time prices, stream insider-scored whale trades, rank top traders, and audit any wallet's P&L — over MCP (Model Context Protocol), the standard supported by Claude, Cursor, n8n, Make, and every major agent framework. Pay per tool call, no API keys, no wallet.

Tools your agent gets

Tool	What it returns
search_markets(query, limit)	Active markets matching a text query, volume-ranked, with live yes-price and URL
get_market(slug)	Live prices, 24h volume, liquidity, end date for one market
whale_trades(min_usd, limit)	Recent large trades with 0–100 insider scores and on-chain tx hashes
top_traders(category, window, order_by, limit)	Trader leaderboard — 10 categories × 4 time windows, by P&L or volume
wallet_profile(wallet)	Open positions, portfolio value, open P&L, activity stats for any wallet

Connect (Claude Desktop / any MCP client)

{
  "mcpServers": {
    "polymarket": {
      "url": "https://mrlarryjohnson--polymarket-mcp-server.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer <your Apify API token>"
      }
    }
  }
}

Get a free Apify token at console.apify.com → Settings → API & Integrations. The server runs in Apify Standby mode (always warm — no cold starts) and bills your Apify account per tool call.

Example prompts once connected:

• "What are the biggest whale trades on Polymarket in the last hour? Anything with an insider score over 60?"
• "Search Polymarket for Fed rate markets and compare the prices."
• "Profile wallet 0xd104… — what are they holding and are they actually profitable?"

Why this server

• Insider scoring, not raw feeds. Whale trades are scored 0–100 with heuristics from a private prediction-market trading engine (conviction longshots, niche-market concentration, late-certainty sweeps).
• Every record is verifiable — on-chain tx hashes, links back to polymarket.com. No black-box numbers.
• Billing integrity: one billed event per successful tool call. Failed calls are never charged, and a rate-limited upstream call fails loudly instead of returning fabricated empty data.
• Always warm — Standby mode means your agent isn't waiting on container cold-starts.

FAQ

• Do I need Polymarket credentials? No — public Polymarket endpoints only. You only need a (free) Apify account token to connect.
• Which clients work? Anything speaking MCP streamable-HTTP: Claude Desktop/claude.ai, Cursor, Windsurf, n8n, Make, LangChain/LlamaIndex MCP adapters.
• Can I also run it as a normal Actor? A normal run just outputs the connection info — the product is the MCP endpoint.
• Is this financial advice? No. Informational data only.

Changelog

• 0.1 — initial release: 5 tools, standby MCP streamable-HTTP, per-tool-call billing.