Polymarket Paper Trader

{
  "mcpServers": {
    "polymarket-paper-trader": {
      "command": "uvx",
      "args": [
        "polymarket-paper-trader"
      ]
    }
  }
}

claude mcp add --transport stdio polymarket-paper-trader -- uvx polymarket-paper-trader

{
  "mcpServers": {
    "polymarket-paper-trader": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "polymarket-paper-trader"
      ]
    }
  }
}

{
  "servers": {
    "polymarket-paper-trader": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "polymarket-paper-trader"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• init_account

  Create paper account with starting balance

• get_balance

  Cash, reserved/available cash, positions value, total P&L

• reset_account

  Wipe all data and start fresh

• search_markets

  Find markets by keyword

• list_markets

  Browse markets sorted by volume/liquidity

• get_tags

  All market categories/tags for filtering

• get_markets_by_tag

  Markets in a specific category/tag

• get_event

  Event details — a group of related markets

• get_market

  Market details with outcomes and prices

• get_order_book

  Live order book snapshot (bids + asks)

• watch_prices

  Monitor prices for multiple markets

• sell

  Sell shares at best available prices

• portfolio

  Open positions with live valuations and P&L

• history

  Recent trade log with execution details

• place_limit_order

  Limit order — stays open until filled or cancelled/expired

• list_orders

  Pending limit orders

• cancel_order

  Cancel a pending order

• cancel_all_orders

  Cancel all pending limit orders at once

• check_orders

  Execute pending orders against live prices

• stats

  Win rate, ROI, profit, max drawdown

• resolve

  Resolve a closed market (winners get $1/share)

• resolve_all

  Resolve all closed markets

• backtest

  Backtest a strategy against historical snapshots (stdio only)

• stats_card

  Shareable stats card (tweet/markdown/plain)

• share_content

  Platform-specific content (twitter/telegram/discord)

• leaderboard_entry

  Generate verifiable leaderboard submission

• leaderboard_card

  Top 10 ranking card from all local accounts

• pk_card

  Head-to-head comparison between two accounts

• pk_battle

  Run two strategies head-to-head, auto-compare (stdio only)

A zero-risk gym for AI agents on real prediction markets — real order books, official fees, verified fill fidelity. Practice, evaluate, and benchmark decision intelligence.

• ai-agent
• algorithmic-trading
• backtesting
• clawhub
• mcp
• openclaw
• paper-trading
• polymarket
• prediction-markets
• python