Polymarket MCP -- The Open-Source Prediction Market Agent

Your AI edge in prediction markets. Search, analyze, detect mispricing, track whales, and trade -- all from your LLM.

What This Is

Most prediction market tools give you a dashboard. This gives you a brain. Polymarket MCP connects any LLM (Claude, GPT, Gemini) to Polymarket's data and wraps it with EV calculations, Kelly sizing, arbitrage detection, news-driven edge finding, and crypto correlation analysis -- all as MCP tools your AI can call autonomously.

Not a toy. Not a wrapper. A full agent toolkit for prediction markets.

Features

Quick Start

git clone https://github.com/Miles0sage/polymarket-mcp.git
cd polymarket-mcp
pip install -r requirements.txt

Add to your MCP config (~/.mcp.json or client settings):

{
  "polymarket": {
    "command": "python3",
    "args": ["server.py"],
    "cwd": "/path/to/polymarket-mcp"
  }
}

No API keys required for market data. Works immediately with Claude Code, Cursor, Windsurf, or any MCP-compatible client.

Architecture

                         +------------------+
                         |   LLM / Client   |
                         | (Claude, GPT...) |
                         +--------+---------+
                                  |
                            MCP Protocol
                                  |
                         +--------v---------+
                         |   MCP Server     |
                         |   (server.py)    |
                         +--------+---------+
                                  |
              +-------------------+-------------------+
              |                   |                   |
     +--------v------+  +--------v------+  +---------v-----+
     | Market Data   |  |  Analysis     |  |  Research      |
     | (tools_       |  |  (tools_      |  |  (tools_       |
     |  markets.py)  |  |   analysis.py)|  |   research.py) |
     +-------+-------+  +-------+-------+  +--------+------+
              |                  |                    |
     +--------v------+  +-------v-------+  +---------v-----+
     | Gamma API     |  | EV / Kelly /  |  | Google News   |
     | CLOB API      |  | Arbitrage     |  | YouTube       |
     +---------------+  +---------------+  | Sentiment     |
                                           +---------------+
              +-------------------+
              |   Crypto Data     |
              |  (tools_crypto.py)|
              +--------+----------+
                       |
              +--------v----------+
              | CoinGecko API     |
              | Fear/Greed Index  |
              +---------+---------+
                        |
                  (Future)
                        |
     +------------------v------------------+
     |  Paper Trading  |  Whale Tracker    |
     |  Risk Manager   |  Alert System     |
     |  CLOB Trading   |  Dashboard UI     |
     +------------------+------------------+

Tool Reference

Market Data (5 tools)

Analysis (3 tools)

Research & Edge Finding (3 tools)

Crypto (4 tools)

Usage Examples

"Search Polymarket for Bitcoin markets"
  -> 10 markets with YES/NO prices, volume, liquidity

"Calculate EV: YES price 0.35, my estimate 0.55"
  -> EV: +57.1%, Quarter-Kelly: 7.7% of bankroll, BET YES

"Check for arbitrage: 0.45, 0.43, 0.08"
  -> ARBITRAGE FOUND! Buy all for $0.96, collect $1.00

"Research: Will Bitcoin hit $200K by end of 2026?"
  -> News headlines, YouTube analysis, sentiment score

"Compare BTC spot price with Polymarket prediction markets"
  -> Current price + all related markets side by side

"What's the Fear & Greed Index saying?"
  -> 7-day chart, current reading, trading signal

Roadmap

• Paper Trading -- Virtual bankroll, position tracking, P&L history
• Whale Tracker -- Monitor top Polymarket wallets, alert on large positions
• Live Trading -- Execute via Polymarket CLOB API (requires wallet + API key)
• WebSocket Feeds -- Real-time price updates instead of polling
• Alert System -- Telegram/Discord notifications on edge triggers
• Dashboard UI -- Web UI for portfolio, positions, edge scanner
• Discord Bot -- Query markets and get alerts in Discord
• One-Click Deploy -- Railway/Render template for hosted instance

Comparison

Contributing

PRs welcome. The codebase is intentionally simple -- pure Python, no frameworks, no databases. Each tool module is standalone.

server.py             # MCP server, tool registration
tools_markets.py      # Market data (Gamma API, CLOB API)
tools_analysis.py     # EV, Kelly, arbitrage math
tools_research.py     # News sentiment, edge finding
tools_crypto.py       # CoinGecko prices, Fear/Greed

License

MIT