polymarket-mcp-server

Trade, analyze, and monitor Polymarket prediction markets through an MCP server with 45 tools.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill polymarket-mcp-server-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket-mcp-server
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/polymarket-mcp-server
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill polymarket-mcp-server-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually researching, trading, and tracking positions on Polymarket prediction markets requires constant attention and exposes traders to uncontrolled risk. This Skill connects Claude to Polymarket via an MCP server so market discovery, analysis, order execution, and portfolio monitoring can be performed conversationally with configurable safety limits. ## Core Features & Use Cases - Market Discovery & Analysis: Search markets, view trending markets, inspect orderbook depth, calculate spreads, and get BUY/SELL/HOLD recommendations with reasoning. - Trading & Portfolio Management: Place limit and market orders, execute natural-language smart trades, track positions, calculate P&L, and analyze portfolio risk with configurable exposure caps. - Real-Time Monitoring: Subscribe to price, orderbook, and trade channels over WebSocket and monitor order status changes live. - Use Case: Ask Claude to find trending election markets, analyze the top opportunity, check liquidity, and place a limit order within your configured maximum order size. ## Quick Start Ask Claude to find trending Polymarket markets from the last 24 hours and analyze the best trading opportunity.

Frequently Asked Questions about polymarket-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trade on Polymarket with Claude?▼

Install the polymarket-mcp-server, add it to claude_desktop_config.json with your Polygon wallet credentials, then ask Claude to search markets and place orders. Claude can place limit orders, market orders, or parse natural-language smart trade instructions.

Can I use the Polymarket MCP server without a crypto wallet?▼

Yes, DEMO mode provides read-only access without requiring a wallet. Set DEMO_MODE=true in your .env file to browse markets, run analysis, and test tools without executing real trades.

What safety limits does Polymarket trading support?▼

The server enforces configurable limits including maximum order size, maximum total exposure, per-market position caps, minimum liquidity requirements, and spread tolerance. Trades above a set dollar threshold can require explicit confirmation before execution.

Does the Polymarket MCP server support real-time market data?▼

Yes, it includes WebSocket support for real-time monitoring. You can subscribe to price, orderbook, and trade channels for specific markets, monitor your order status changes, and check connection state with the get_websocket_status tool.

Why does my Polymarket order fail validation?▼

Orders fail when market liquidity falls below MIN_LIQUIDITY_REQUIRED, the spread exceeds MAX_SPREAD_TOLERANCE, or the order size exceeds configured limits. Check orderbook depth and calculate the spread before placing orders to avoid rejections.