agent-next avatar

Polymarket Paper Trader

agent-next/polymarket-paper-trader

Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.

GitHub stars
498
tools
32
transport
STDIO
last updated
Oct 15, 2026

Tools

32 tools

Public tool metadata for what this MCP can expose to an agent.

init_accountCreate paper account with starting balance

Create paper account with starting balance

No parameter schema in public metadata yet.

get_balanceCash, reserved/available cash, positions value, total P&L

Cash, reserved/available cash, positions value, total P&L

No parameter schema in public metadata yet.

reset_accountWipe all data and start fresh

Wipe all data and start fresh

No parameter schema in public metadata yet.

search_marketsFind markets by keyword

Find markets by keyword

No parameter schema in public metadata yet.

list_marketsBrowse markets sorted by volume/liquidity

Browse markets sorted by volume/liquidity

No parameter schema in public metadata yet.

get_tagsAll market categories/tags for filtering

All market categories/tags for filtering

No parameter schema in public metadata yet.

get_markets_by_tagMarkets in a specific category/tag

Markets in a specific category/tag

No parameter schema in public metadata yet.

get_eventEvent details — a group of related markets

Event details — a group of related markets

No parameter schema in public metadata yet.

get_marketMarket details with outcomes and prices

Market details with outcomes and prices

No parameter schema in public metadata yet.

get_order_bookLive order book snapshot (bids + asks)

Live order book snapshot (bids + asks)

No parameter schema in public metadata yet.

kalshi_marketsKalshi markets, read-only (open/closed/settled, by series or event)

Kalshi markets, read-only (open/closed/settled, by series or event)

No parameter schema in public metadata yet.

kalshi_marketOne Kalshi market by ticker, read-only

One Kalshi market by ticker, read-only

No parameter schema in public metadata yet.

kalshi_bookLive Kalshi YES order book, read-only

Live Kalshi YES order book, read-only

No parameter schema in public metadata yet.

watch_pricesMonitor prices for multiple markets

Monitor prices for multiple markets

No parameter schema in public metadata yet.

buyBuy shares at best available prices

Buy shares at best available prices

No parameter schema in public metadata yet.

sellSell shares at best available prices

Sell shares at best available prices

No parameter schema in public metadata yet.

portfolioOpen positions with live valuations and P&L

Open positions with live valuations and P&L

No parameter schema in public metadata yet.

historyRecent trade log with execution details

Recent trade log with execution details

No parameter schema in public metadata yet.

place_limit_orderLimit order — stays open until filled or cancelled/expired

Limit order — stays open until filled or cancelled/expired

No parameter schema in public metadata yet.

list_ordersPending limit orders

Pending limit orders

No parameter schema in public metadata yet.

cancel_orderCancel a pending order

Cancel a pending order

No parameter schema in public metadata yet.

cancel_all_ordersCancel all pending limit orders at once

Cancel all pending limit orders at once

No parameter schema in public metadata yet.

check_ordersExecute pending orders against live prices

Execute pending orders against live prices

No parameter schema in public metadata yet.

resolveResolve a closed market (winners get $1/share)

Resolve a closed market (winners get $1/share)

No parameter schema in public metadata yet.

resolve_allResolve all closed markets

Resolve all closed markets

No parameter schema in public metadata yet.

backtestBacktest a strategy against historical snapshots (stdio only)

Backtest a strategy against historical snapshots (stdio only)

No parameter schema in public metadata yet.

stats_cardShareable stats card (tweet/markdown/plain)

Shareable stats card (tweet/markdown/plain)

No parameter schema in public metadata yet.

share_contentPlatform-specific content (twitter/telegram/discord)

Platform-specific content (twitter/telegram/discord)

No parameter schema in public metadata yet.

leaderboard_entryGenerate verifiable leaderboard submission

Generate verifiable leaderboard submission

No parameter schema in public metadata yet.

leaderboard_cardTop 10 ranking card from all local accounts

Top 10 ranking card from all local accounts

No parameter schema in public metadata yet.

pk_cardHead-to-head comparison between two accounts

Head-to-head comparison between two accounts

No parameter schema in public metadata yet.

pk_battleRun two strategies head-to-head, auto-compare (stdio only)

Run two strategies head-to-head, auto-compare (stdio only)

No parameter schema in public metadata yet.

Sponsors

Readme

polymarket-paper-trader

PyPI PyPI downloads Tests ClawHub License: MIT

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.


View the full README on GitHub

Details

Repository
github.com/agent-next/polymarket-paper-trader
Categories
AI & LLM Tools, Finance & Commerce
Package
polymarket-paper-trader
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1salitronic avatareda-agentsalitronic/eda-agentDrive a live Altium Designer session: schematic, PCB and library tools. KiCad and EasyEDA too.351stars
2cyberchitta avatarllm-contextcyberchitta/llm-context.pyShare code with LLMs via Model Context Protocol or clipboard. Rule-based customization enables easy switching between different tasks (like code review and docu300stars
3nirholas avatarthree.ws 3D Agent Toolsnirholas/three.wsMCP tools from three.ws: free + paid text-to-3D, rigging, agent reputation, market intel.269stars
4sachitrafa avatarCognitive Ai Memorysachitrafa/cognitive-ai-memoryEbbinghaus-based persistent memory for Claude. Memories decay with time, strengthen on recall.244stars
5taisly avatarTaisly Social Media Postingtaisly/agentPublish videos to TikTok, Reels, Shorts, X, and Facebook through Taisly.222stars
6slow-stack avatarMneme Memoryslow-stack/mnemeCross-session memory for AI coding agents via six tools; local-first SQLite store.211stars