Polymarket Paper Trader MCP server
Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.
399 stars
Reviews
Write oneNobody has reviewed Polymarket Paper Trader yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Polymarket Paper Trader tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan16 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
What the publisher says
From the Polymarket Paper Trader repository's README, as published. We do not edit it. Read it on GitHub
polymarket-paper-trader
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.
Agents make probability judgments all day. Polymarket is the world's largest prediction market, and its order books are the honest scoreboard: real money, real prices, real outcomes. But you cannot hand an agent a wallet to learn with. So this project gives every agent what SWE-bench gave coders — a faithful environment where judgment has consequences and gets scored:
- Practice — your agent trades $10k of paper money against live Polymarket order books, with the same fee model and fill mechanics as the real exchange
- Evaluate — the polymarket-benchmark harness in this repository (installed separately) scores any model on prediction-market decision sets (Brier score, calibration, alpha)
- Compare — multi-account battles and leaderboards rank agents against each other
Part of agent-next — building an agentic world.
60-second demo
npx clawhub install polymarket-paper-trader # install via ClawHub
pm-trader init --balance 10000 # $10k paper money
pm-trader markets search "bitcoin" # find markets
pm-trader buy will-bitcoin-hit-100k yes 500 # buy $500 of YES
pm-trader stats --card # shareable stats cardThat's it. Your AI agent is now trading Polymarket with zero risk.
Install
# via pip
pip install polymarket-paper-trader
# via ClawHub (for OpenClaw agents)
npx clawhub install polymarket-paper-trader
# from source (development)
uv pip install -e ".[dev]"Requires Python 3.10+.
Works with
Full copy-paste config for every runtime above (plus Grok/xAI remote MCP): docs/integrations.md.
Quick start
# Initialize with $10k paper balance
pm-trader init --balance 10000
# Browse markets
pm-trader markets list --sort liquidity
pm-trader markets search "bitcoin"
# Trade
pm-trader buy will-bitcoin-hit-100k yes 100 # buy $100 of YES
pm-trader sell will-bitcoin-hit-100k yes 50 # sell 50 shares
# Check portfolio and P&L
pm-trader portfolio
pm-trader statsHow it works — and why to trust it
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add polymarket-paper-trader -- uvx polymarket-paper-trader
Polymarket Paper Trader: common questions
- Is Polymarket Paper Trader MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the Polymarket Paper Trader safety report
- How do I install Polymarket Paper Trader?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Polymarket Paper Trader need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Polymarket Paper Trader maintained?
- The last commit was in the last day (2026-09-26). The latest release is v0.4.1.
- What can I use instead of Polymarket Paper Trader?
- Servers from other publishers that do the same job: Polymarket Toolkit MCP server, Robinhood Crypto MCP server and MCP Server. Compare all Polymarket Paper Trader alternatives.
Alternatives to Polymarket Paper Trader
Same job from other publishers: the closest match first, then the best rated.
- Polymarket ToolkitRead-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.not reviewedEstablishedB
- Robinhood CryptoRobinhood Crypto Trading API for AI agents: quotes, holdings, orders read-only; opt-in trading.not reviewedGrowingB
MCP ServerPhone numbers for AI agents: order a private number, read the SMS verification code, hand it back.not reviewedEstablishedB
Federal RegisterFederal Register proposed and final rules, notices, executive orders, and FAR cases. 8 tools.not reviewedEstablishedA- ShopwareQuery and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.not reviewedEstablishedB
