Polymarket MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Polymarket MCP Serverlist active prediction markets"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@c0pilot/mcp-polymarket
MCP (Model Context Protocol) server and client library for Polymarket prediction markets.
Features
MCP Server: Run as a standalone MCP server for AI agents
Client Library: Import and use in your own projects
Browse and search prediction markets
View order books and market prices
Check wallet balance and positions
Place and cancel orders
Full integration with Polymarket's CLOB API
Related MCP server: Polymarket MCP Server
Installation
npm install @c0pilot/mcp-polymarketUsage
As MCP Server
With Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"polymarket": {
"command": "npx",
"args": ["mcp-polymarket"],
"env": {
"POLYMARKET_PRIVATE_KEY": "0x...",
"POLYMARKET_FUNDER": "0x..."
}
}
}
}Standalone
export POLYMARKET_PRIVATE_KEY="0x..."
export POLYMARKET_FUNDER="0x..."
npx mcp-polymarketAs Library
import { ClobClientWrapper } from 'mcp-polymarket/client';
import { createConfig } from 'mcp-polymarket/config';
// Create config
const config = createConfig({
privateKey: '0x...',
funder: '0x...', // optional
readonly: false, // optional
});
// Initialize client
const client = new ClobClientWrapper(config);
await client.initialize();
// Use the client
const clobClient = client.getClient();
const orderbook = await clobClient.getOrderBook(tokenId);Configuration
Environment Variables
Variable | Required | Default | Description |
| Yes | - | Wallet private key for signing |
| No | derived | Proxy wallet address |
| No | derived | API key (auto-derived if not set) |
| No | derived | API secret (auto-derived if not set) |
| No | derived | API passphrase (auto-derived if not set) |
| No | 137 | Polygon mainnet |
| No | false | Disable trading tools |
Finding Your Funder Address
Your "funder" is your Polymarket proxy wallet - the address shown on polymarket.com when logged in. If you deposited through Polymarket's UI, funds are in this proxy wallet.
Available MCP Tools
Read-Only
Tool | Description |
| List active prediction markets |
| Get details for a specific market |
| View order book for a token |
| Check wallet USDC balance |
| View open orders and positions |
| Get recent trade history |
Trading
Tool | Description |
| Place a limit order (BUY/SELL) |
| Cancel an open order |
API Exports
// Main MCP server entry
import mcp from '@c0pilot/mcp-polymarket';
// Client wrapper for Polymarket CLOB
import { ClobClientWrapper } from '@c0pilot/mcp-polymarket/client';
// Configuration utilities
import { createConfig, getConfig, Config } from '@c0pilot/mcp-polymarket/config';
// Type definitions
import { MarketInfo, OrderbookInfo, Position } from '@c0pilot/mcp-polymarket/types';Security
Private keys are never logged
Use
POLYMARKET_READONLY=truefor safe explorationAPI credentials auto-derived from private key
Input validation on all parameters
Development
# Install dependencies
npm install
# Build
npm run build
# Run tests
npm test
# Run E2E tests (requires env vars)
npm run test:e2eRelated
@c0pilot/openclaw-polymarket - OpenClaw plugin using this library
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceEnables access to Polymarket's prediction markets for analyzing market probabilities, trading activity, and event outcomes across politics, sports, crypto, and other categories through natural language queries.2510MIT
- AlicenseBquality-maintenanceEnables 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 books through the Model Context Protocol.5925
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Polymarket prediction markets, including retrieving market data, user positions, and trading history.81210Apache 2.0
- Alicense-qualityDmaintenanceEnables LLM agents to interact with Polymarket prediction markets, including market discovery, real-time pricing, analytics, account management, and trading with built-in safety guards.MIT
Related MCP Connectors
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier.
Polymarket MCP — prediction-market data via Gamma + CLOB public APIs.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/unsanction/mcp-polymarket'
If you have feedback or need assistance with the MCP directory API, please join our Discord server