Polymarket
Enables AI agents to interact with the Polymarket prediction market platform to discover markets, analyze real-time pricing, and monitor public portfolio data. It provides comprehensive access to market analytics, implied probabilities, and order boo
What is Polymarket?
Polymarket is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai agents to interact with the polymarket prediction market platform to discover markets, analyze real-time pricing, and monitor public portfolio data. it provides comprehensive access to mark...
Enables AI agents to interact with the Polymarket prediction market platform to discover markets, analyze real-time pricing, and monitor public portfolio data. It provides comprehensive access to market analytics, implied probabilities, and order boo
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI agents to interact with the Polymarket prediction
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx polymarket-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Polymarket
The Polymarket MCP Server gives AI agents like Claude full access to the Polymarket prediction market platform through 45 comprehensive tools spanning market discovery, real-time analysis, trading, portfolio management, and live WebSocket monitoring. It connects to the Polygon blockchain and Polymarket's API to enable autonomous market research and — with a configured Polygon wallet — actual order placement with enterprise-grade safety limits. Traders, researchers, and AI agent builders use it to analyze implied probabilities, monitor orderbook depth, and automate prediction market strategies.
Prerequisites
- Python 3.10 or later
- Git to clone the repository (no PyPI package — install from source)
- A Polygon (MATIC) wallet with private key for trading (not required for DEMO read-only mode)
- Polygon USDC balance in your wallet for placing orders (full trading mode only)
- An MCP client such as Claude Desktop
Clone the repository
Clone the polymarket-mcp-server repository from GitHub. There is no PyPI package, so installation is from source.
git clone https://github.com/caiovicentino/polymarket-mcp-server.git
cd polymarket-mcp-serverRun the automated installer
Use the provided install script for the easiest setup. Choose quickstart for DEMO mode (no wallet needed) or full install for trading.
# DEMO mode (read-only, no wallet required)
./quickstart.sh
# Full trading setup
./install.shConfigure your environment file
Copy the example .env file and fill in your credentials. For DEMO mode, only set DEMO_MODE=true. For trading, add your Polygon wallet details and safety limits.
cp .env.example .env
# Edit .env with your values:
# DEMO_MODE=true (read-only, no wallet needed)
# -- or for full trading --
# POLYGON_PRIVATE_KEY=your_private_key_without_0x_prefix
# POLYGON_ADDRESS=0xYourPolygonAddress
# MAX_ORDER_SIZE_USD=1000
# MAX_TOTAL_EXPOSURE_USD=5000
# REQUIRE_CONFIRMATION_ABOVE_USD=500Add the server to Claude Desktop
Update your claude_desktop_config.json to point to the Python entry point. The server uses stdio transport.
{
"mcpServers": {
"polymarket": {
"command": "python",
"args": ["-m", "polymarket_mcp_server"],
"cwd": "/path/to/polymarket-mcp-server",
"env": {
"DEMO_MODE": "true"
}
}
}
}Launch the optional web dashboard
Start the web dashboard for a visual interface to manage configuration, monitor market data, and view system stats.
polymarket-web
# Then open http://localhost:8080Polymarket Examples
Client configuration
Example claude_desktop_config.json for DEMO mode (read-only market analysis). Replace the cwd path with your actual clone location.
{
"mcpServers": {
"polymarket": {
"command": "python",
"args": ["-m", "polymarket_mcp_server"],
"cwd": "/path/to/polymarket-mcp-server",
"env": {
"DEMO_MODE": "true",
"MAX_ORDER_SIZE_USD": "1000",
"MAX_TOTAL_EXPOSURE_USD": "5000",
"REQUIRE_CONFIRMATION_ABOVE_USD": "500"
}
}
}
}Prompts to try
Ask Claude to research and analyze prediction markets via Polymarket. In DEMO mode all prompts work except actual order placement.
- "What are the top trending prediction markets on Polymarket right now by volume?"
- "Analyze the current orderbook for the US election market and tell me the implied probability"
- "Find all crypto-related markets closing in the next 7 days and rank them by liquidity"
- "Compare the top 5 NBA championship markets and identify which has the best spread"
- "Show me my current portfolio positions and calculate total P&L"Troubleshooting Polymarket
Authentication errors or 401 responses when placing orders
Full trading mode requires both POLYGON_PRIVATE_KEY (without the 0x prefix) and POLYGON_ADDRESS set in your .env file. The server uses EIP-712 signing and both L1 (wallet) and L2 (API key) authentication — ensure both are configured correctly.
WebSocket connections drop or real-time monitoring stops working
The server implements auto-reconnect with exponential backoff, so brief disconnects should recover automatically. If monitoring stays disconnected, check your network connection and verify the Polymarket WebSocket endpoint is reachable. Restart the MCP server if the issue persists.
Order rejected due to safety limit violations
The server enforces configurable safety limits including MAX_ORDER_SIZE_USD, MAX_TOTAL_EXPOSURE_USD, MAX_POSITION_SIZE_PER_MARKET, and MIN_LIQUIDITY_REQUIRED. Review these values in your .env file and adjust them to match your trading risk tolerance.
Frequently Asked Questions about Polymarket
What is Polymarket?
Polymarket is a Model Context Protocol (MCP) server that enables ai agents to interact with the polymarket prediction market platform to discover markets, analyze real-time pricing, and monitor public portfolio data. it provides comprehensive access to market analytics, implied probabilities, and order boo It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Polymarket?
Follow the installation instructions on the Polymarket GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Polymarket?
Polymarket works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Polymarket free to use?
Yes, Polymarket is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Polymarket Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Polymarket? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Polymarket in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Polymarket?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.