Is Polymarket Paper Trader safe to use?

Polymarket Paper Trader has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install Polymarket Paper Trader?

Polymarket Paper Trader supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Polymarket Paper Trader do?

Polymarket Paper Trader provides 26 tools: init_account, get_balance, reset_account, search_markets, list_markets and 21 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Polymarket Paper Trader?

Polymarket Paper Trader is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.

Is Polymarket Paper Trader actively maintained?

Polymarket Paper Trader is recently maintained — last commit was 87 days ago. It has 339 GitHub stars.

Polymarket Paper Trader

Name: Polymarket Paper Trader
Author: agent-next

clawhub · by agent-next

Paper trading simulator for Polymarket — built for AI agents. MCP server, live order books, strategy backtesting. Install: npx clawhub install polymarket-paper-trader

339 92.0k/wk 26 tools GitHub npm PyPI

No known CVEs

MIT license

Maintained

Last commit 87d ago

Works with most clients

Transport: stdio, sse

26 tools · ~1.8k tok

Grade C · 0.9% of 200K ctx

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "polymarket-paper-trader": {
      "command": "pm-trader-mcp"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/polymarket-paper-trader)](https://mcppedia.org/s/polymarket-paper-trader)

Read me

What Polymarket Paper Trader does

Install → your agent gets $10,000 paper money → trades real Polymarket order books → tracks P&L → competes on a public leaderboard. Zero risk. Real prices.

Test This Server

This server supports HTTP transport. Be the first to test it — help the community know if it works.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

82/100across 5 weighted dimensions

How we score →

0255075100

−18

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked clawhub against OSV.dev.

Inventory

Tools (26)

Click any tool to inspect its schema.

~1.8k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Polymarket Paper Trader safe to use?: Polymarket Paper Trader has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Polymarket Paper Trader?: Polymarket Paper Trader supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Polymarket Paper Trader do?: Polymarket Paper Trader provides 26 tools: init_account, get_balance, reset_account, search_markets, list_markets and 21 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Polymarket Paper Trader?: Polymarket Paper Trader is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is Polymarket Paper Trader actively maintained?: Polymarket Paper Trader is recently maintained — last commit was 87 days ago. It has 339 GitHub stars.

Similar servers

Others in finance

View all →

Alpha Vantage Mcp95

Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

158 3

Investor Agent93

A Model Context Protocol server for building an investor agent

328 7

io.github.xkumakichi/xaip-mcp-server92

AI agents get on-chain identity, credentials, reputation, escrow, and persistent memory on XRPL.

io.github.PayRam/payram-helper-mcp91

Remote MCP server to integrate and validate self-hosted PayRam deployments.

155 17

MCP Security Weekly

Get CVE alerts and security updates for Polymarket Paper Trader and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "polymarket-paper-trader": {
      "command": "pm-trader-mcp"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/polymarket-paper-trader)](https://mcppedia.org/s/polymarket-paper-trader)

Read me

What Polymarket Paper Trader does

Install → your agent gets $10,000 paper money → trades real Polymarket order books → tracks P&L → competes on a public leaderboard. Zero risk. Real prices.

Test This Server

This server supports HTTP transport. Be the first to test it — help the community know if it works.

README

polymarket-paper-trader

Your AI agent just became a Polymarket trader.

Install → your agent gets $10,000 paper money → trades real Polymarket order books → tracks P&L → competes on a public leaderboard. Zero risk. Real prices.

"My AI agent hit +18% ROI on Polymarket in one week. Zero risk, real order books."

Part of agent-next — open research lab for self-evolving autonomous agents.

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 card

That'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+.

Not a toy — this is a real exchange simulator

Other tools mock prices or use random numbers. We simulate the actual exchange:

Level-by-level order book execution — your order walks the real Polymarket ask/bid book, consuming liquidity at each price level, just like a real trade
Exact fee model — bps/10000 × min(price, 1-price) × shares — the same formula Polymarket uses
Slippage tracking — every trade records how much worse your fill was vs the midpoint, in basis points
Limit order state machine — GTC (good-til-cancelled) and GTD (good-til-date) with full lifecycle
Strategy backtesting — replay your strategy against historical price snapshots
Multi-outcome markets — not just YES/NO binary, supports any number of outcomes

Your paper P&L would match real P&L within the spread. That's the point.

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 stats

CLI commands

Command	Description
`init [--balance N]`	Create paper trading account
`balance`	Show cash, positions value, total P&L
`reset --confirm`	Wipe all data
`markets list [--limit N] [--sort volume\|liquidity]`	Browse active markets
`markets search QUERY`	Full-text market search
`markets get SLUG`	Market details
`price SLUG`	YES/NO midpoints and spread
`book SLUG [--depth N]`	Order book snapshot
`watch SLUG [SLUG...] [--outcome yes\|no]`	Monitor live prices
`buy SLUG OUTCOME AMOUNT [--type fok\|fak]`	Buy at market price
`sell SLUG OUTCOME SHARES [--type fok\|fak]`	Sell at market price
`portfolio`	Open positions with live prices
`history [--limit N]`	Trade history
`orders place SLUG OUTCOME SIDE AMOUNT PRICE`	Limit order
`orders list`	Pending limit orders
`orders cancel ID`	Cancel a limit order
`orders check`	Fill limit orders if price crosses
`stats [--card\|--tweet\|--plain]`	Win rate, ROI, profit, max drawdown

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

82/100across 5 weighted dimensions

How we score →

0255075100

−18

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked clawhub against OSV.dev.

Inventory

Tools (26)

Click any tool to inspect its schema.

~1.8k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Polymarket Paper Trader safe to use?: Polymarket Paper Trader has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Polymarket Paper Trader?: Polymarket Paper Trader supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Polymarket Paper Trader do?: Polymarket Paper Trader provides 26 tools: init_account, get_balance, reset_account, search_markets, list_markets and 21 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Polymarket Paper Trader?: Polymarket Paper Trader is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is Polymarket Paper Trader actively maintained?: Polymarket Paper Trader is recently maintained — last commit was 87 days ago. It has 339 GitHub stars.