Polymarket Paper Trader — Claude Code MCP server
This MCP server lets an AI agent paper-trade prediction markets with real Polymarket order books and official fees. Use it to practise and evaluate decisions.
claude mcp add polymarket-paper-trader -- uvx polymarket-paper-traderWhat Polymarket Paper Trader does
Polymarket Paper Trader gives an agent a $10k paper balance and access to Polymarket markets. It can search markets, place buys and sells, inspect a portfolio, view stats, and resolve closed markets. Orders walk the live order book, so the simulation includes slippage, partial fills, and the market’s published fee model.
The server runs through uvx and can be added to Claude Code with one command. Kalshi markets are supported through slugs prefixed with kalshi: and use the same commands and tools. Python 3.10+ is required; without it, the server will not run. Hosts with MCP Apps support can render portfolio and stats as an inline dashboard.
What it helps with
- train an agent on prediction markets without real funds
- test trades against live Polymarket order books
- account for fees and slippage in paper trades
- compare agents through trading results
- paper-trade Kalshi markets with the same commands
Example prompts for the agent
- Find Polymarket markets about bitcoin and show their liquidity.
- Buy 100 of YES on
will-bitcoin-hit-100k. - Show my paper-trading portfolio and stats.
How to install Polymarket Paper Trader
Platform CLI
claude mcp add polymarket-paper-trader -- uvx polymarket-paper-traderuvx runs the command named after the package; if the README names another one, use uvx --from polymarket-paper-trader <command>
Platform CLI
codex mcp add polymarket-paper-trader -- uvx polymarket-paper-traderuvx runs the command named after the package; if the README names another one, use uvx --from polymarket-paper-trader <command>
Config file
{
"mcpServers": {
"polymarket-paper-trader": {
"command": "uvx",
"args": [
"polymarket-paper-trader"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from polymarket-paper-trader <command>
Config file
{
"servers": {
"polymarket-paper-trader": {
"type": "stdio",
"command": "uvx",
"args": [
"polymarket-paper-trader"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from polymarket-paper-trader <command>
Platform CLI
gemini mcp add polymarket-paper-trader uvx polymarket-paper-traderuvx runs the command named after the package; if the README names another one, use uvx --from polymarket-paper-trader <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Polymarket Paper Trader
How do I install Polymarket Paper Trader in Claude Code?
Run claude mcp add polymarket-paper-trader -- uvx polymarket-paper-trader.
What does Polymarket Paper Trader do?
It lets an AI agent trade paper money on Polymarket using live order books and the official fee model. The server also provides portfolio and trading stats.
Which platforms work with Polymarket Paper Trader?
It supports Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed through their MCP settings.
