Log inSubmit server
Polymarket Paper Trader logo

Polymarket Paper Trader

Paper-trade Polymarket markets with live order books, simulated fills, fees, portfolios, strategies, and performance comparisons.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Polymarket Paper Trader

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "polymarket-paper-trader": {
      "command": "uvx",
      "args": [
        "--from",
        "polymarket-paper-trader",
        "pm-trader-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 30 tools correctly (27d ago).

Overview

Polymarket Paper Trader MCP server gives AI agents a paper account for trading against live Polymarket market data. It exposes tools for discovering markets, inspecting order books, placing market or limit trades, tracking positions, and resolving closed markets. The simulator uses paper cash while applying published fee behavior and order-book execution mechanics. Reach for it when you need to practice, backtest, evaluate, or compare prediction-market strategies without using real funds.

Use cases

  • Practice prediction-market trading with simulated funds
  • Evaluate strategies against live Polymarket order books
  • Backtest strategies against historical market snapshots
  • Compare multiple paper-trading accounts
  • Track simulated portfolio performance and drawdown

Key features

  • Live Polymarket market and order-book data
  • Market and limit paper trading
  • Fee-aware simulated fills and slippage
  • Portfolio, trade history, and performance statistics
  • Strategy backtesting and account comparisons
  • Leaderboard and shareable performance outputs

Tools30

What Polymarket Paper Trader lets your agent do. Expand a tool for its parameters.

Verified live~2.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

15/15 checks healthy over the last 37d

What it can do

From the 30 tools this server returned when we ran it; 30 declare their own safety hints.

Runs commands · 1Can delete or modify data · 6Makes network requests · 24Read-only tools · 23
Network at startup2 connections
Files written at startup30

Observed 2026-10-15 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · polymarket-paper-trader (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars504Stargazers on the source repository.
Last commit10d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed30Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Polymarket Paper Trader works

What Polymarket Paper Trader MCP server does

The Polymarket Paper Trader MCP server connects AI agents to Polymarket market data and a local paper-trading account. Accounts start with a configurable balance, with the example workflow using $10,000. Agents can search and filter markets, inspect events and outcomes, observe live order books, trade shares, and review portfolio performance.

Trading is simulated rather than funded with real money. The account tracks cash, reserved cash, available cash, positions, trade history, open orders, realized results, and performance statistics. Multiple local accounts can support strategy comparisons and head-to-head tests.

How it works

Market buys and sells execute against live Polymarket order-book levels. A buy consumes available asks from the lowest price upward, while execution can include slippage and partial fills. Limit orders remain open until they fill, are cancelled, or expire; reserved cash is retained for resting buy orders.

Fees follow the published per-match fee curve for the market, with fees calculated for each filled level. The system also validates limit prices against tick size and rejects trades for closed or paused markets. Closed markets can be resolved so winning shares pay $1 each.

The server can run over standard input/output with pm-trader-mcp, or over streamable HTTP using the --transport streamable-http option. Backtesting and head-to-head strategy battles are available through stdio only.

Setup and configuration

Install the package with Python 3.10 or newer:

Terminal
pip install polymarket-paper-trader

Start the MCP server locally with:

bash
pm-trader-mcp

For an installation-free launch, the README provides this command:

bash
uvx --from polymarket-paper-trader pm-trader-mcp

The Polymarket Paper Trader MCP server can also be configured for streamable HTTP:

bash
pm-trader-mcp --transport streamable-http --host 127.0.0.1 --port 8000

The HTTP endpoint is /mcp. Optional global settings include PM_TRADER_DATA_DIR for the data location and PM_TRADER_ACCOUNT for selecting a named account.

Tools and capabilities

The Polymarket Paper Trader MCP server exposes tools for:

  • Creating, resetting, and inspecting paper accounts.
  • Searching markets, listing them by volume or liquidity, and filtering by tags.
  • Reading event details, market outcomes, prices, and live order-book snapshots.
  • Watching prices across multiple markets.
  • Buying and selling at the best available prices.
  • Placing, listing, checking, and cancelling limit orders, including bulk cancellation.
  • Viewing portfolios, trade history, win rate, ROI, profit, and maximum drawdown.
  • Resolving individual or all eligible closed markets.
  • Backtesting strategies against historical snapshots through stdio.
  • Generating statistics cards, platform-specific sharing content, leaderboard entries, rankings, and account comparisons.

The repository also provides a command-line interface for the same trading workflow, including account management, exports, strategy execution, and benchmark aliases.

Limitations and notes

This tool does not provide a real-money trading wallet. Balances and positions are paper records, while market information and order-book inputs come from Polymarket APIs.

Resolution is an explicit step: an agent must call the resolution tool after a market closes for winning positions to receive their $1-per-share payout. The project supports markets with multiple outcomes, not only binary YES/NO markets. Live API behavior and data availability therefore affect what the agent can discover and trade.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Polymarket Paper Trader

Polymarket Paper Trader is an MCP server that connects AI agents to Polymarket market data and local paper accounts. Its main tools discover markets, inspect live order books, buy and sell shares, manage limit orders, track portfolios, resolve markets, and calculate trading statistics without using real funds.

Install it with `pip install polymarket-paper-trader` and start it with `pm-trader-mcp`. Python 3.10 or newer is required. You can also launch it without a local package installation using `uvx --from polymarket-paper-trader pm-trader-mcp`.

Yes, Polymarket Paper Trader works with Cursor through its MCP configuration. The README provides a Cursor installation link and identifies Cursor among the supported runtimes.

Yes, run `pm-trader-mcp --transport streamable-http` to use streamable HTTP. The MCP endpoint is available at `/mcp`, and the host and port can be supplied with `--host` and `--port`.

No, Polymarket Paper Trader uses paper balances and local simulated accounts. It reads live Polymarket order books and applies documented execution and fee behavior, but it does not provide a real-money wallet.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPolymarket Paper Trader AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/polymarket-paper-trader?style=directory)](https://allmcps.com/mcp/polymarket-paper-trader)
HTML Embed
<a href="https://allmcps.com/mcp/polymarket-paper-trader"><img src="https://allmcps.com/api/badge/polymarket-paper-trader?style=directory" alt="Polymarket Paper Trader on AllMCPs" /></a>