Polymarket Paper Trader
Polymarket Paper Trader is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Polymarket paper trading for AI agents: $10k paper money, real order books, official fees. It has 492 GitHub stars, is released under the MIT license and runs locally with uvx polymarket-paper-trader.
github.com/agent-next/polymarket-paper-trader (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install Polymarket Paper Trader
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"polymarket-paper-trader": {
"command": "uvx",
"args": [
"polymarket-paper-trader"
]
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --transport stdio polymarket-paper-trader -- uvx polymarket-paper-traderCursor
{
"mcpServers": {
"polymarket-paper-trader": {
"type": "stdio",
"command": "uvx",
"args": [
"polymarket-paper-trader"
]
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"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).
Tools (32)
Parsed from the Tools section of the README; check the repository for the current list.
init_accountCreate paper account with starting balance
get_balanceCash, reserved/available cash, positions value, total P&L
reset_accountWipe all data and start fresh
search_marketsFind markets by keyword
list_marketsBrowse markets sorted by volume/liquidity
get_tagsAll market categories/tags for filtering
get_markets_by_tagMarkets in a specific category/tag
get_eventEvent details — a group of related markets
get_marketMarket details with outcomes and prices
get_order_bookLive order book snapshot (bids + asks)
kalshi_marketsKalshi markets, read-only (open/closed/settled, by series or event)
kalshi_marketOne Kalshi market by ticker, read-only
kalshi_bookLive Kalshi YES order book, read-only
watch_pricesMonitor prices for multiple markets
sellSell shares at best available prices
portfolioOpen positions with live valuations and P&L
historyRecent trade log with execution details
place_limit_orderLimit order — stays open until filled or cancelled/expired
list_ordersPending limit orders
cancel_orderCancel a pending order
cancel_all_ordersCancel all pending limit orders at once
check_ordersExecute pending orders against live prices
statsWin rate, ROI, profit, max drawdown
resolveResolve a closed market (winners get $1/share)
resolve_allResolve all closed markets
backtestBacktest a strategy against historical snapshots (stdio only)
stats_cardShareable stats card (tweet/markdown/plain)
share_contentPlatform-specific content (twitter/telegram/discord)
leaderboard_entryGenerate verifiable leaderboard submission
leaderboard_cardTop 10 ranking card from all local accounts
pk_cardHead-to-head comparison between two accounts
pk_battleRun two strategies head-to-head, auto-compare (stdio only)
About 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.
- ai-agent
- algorithmic-trading
- backtesting
- clawhub
- mcp
- openclaw
- paper-trading
- polymarket
- prediction-markets
- python
Similar MCP servers
More finance MCP servers
Oracle3 prediction-market arbitrage checks
YichengYang-Ethan/oracle3-prediction-market-agent
Kalshi and Polymarket data, venue fees, no-arbitrage checks and paper execution for AI agents.
Active · last commit Oct 12, 2026
FinancePythonEVMole
cdump/evmole
Local structured analysis of deployed EVM runtime bytecode.
Active · last commit Oct 24, 2026
FinanceRustEmilia Protocol
emiliaprotocol/emilia-protocol
Exact-action approval for consequential agent actions: request, track, and verify signed receipts.
Maintained · last commit Oct 7, 2026
FinanceTypeScriptOpenAccountants
openaccountants/openaccountants
Open-source AI accounting skills verified by licensed accountants (tax, VAT, payroll).
Active · last commit Oct 26, 2026
FinancePythonMaverick MCP
wshobson/maverick-mcp
Stock market MCP server for Yahoo Finance data, technical analysis, portfolio tracking, and Python backtesting.
Active · last commit Oct 17, 2026
FinancePythonStock Screener
xang1234/stock-screener
Daily stock screens, RS ratings, market breadth and group rankings for 12 markets.
Active · last commit Oct 25, 2026
FinancePython
How do I install the Polymarket Paper Trader MCP server?
Add the command uvx polymarket-paper-trader to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Polymarket Paper Trader free?
The server is open source under the MIT license, so running it is free. It does not declare any required API key.
Is Polymarket Paper Trader actively maintained?
The most recent commit was on Oct 15, 2026. The latest release is v0.4.13, published Oct 15, 2026. appsgit only lists MCP servers with a commit in the last six months.