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
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- 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