@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

Installation

npm install @c0pilot/mcp-polymarket

Usage

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-polymarket

As 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
POLYMARKET_PRIVATE_KEY	Yes	-	Wallet private key for signing
POLYMARKET_FUNDER	No	derived	Proxy wallet address
POLYMARKET_API_KEY	No	derived	API key (auto-derived if not set)
POLYMARKET_API_SECRET	No	derived	API secret (auto-derived if not set)
POLYMARKET_PASSPHRASE	No	derived	API passphrase (auto-derived if not set)
POLYMARKET_CHAIN_ID	No	137	Polygon mainnet
POLYMARKET_READONLY	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
polymarket_get_markets	List active prediction markets
polymarket_get_market	Get details for a specific market
polymarket_get_orderbook	View order book for a token
polymarket_get_balance	Check wallet USDC balance
polymarket_get_positions	View open orders and positions
polymarket_get_trades	Get recent trade history

Trading

Tool	Description
polymarket_place_order	Place a limit order (BUY/SELL)
polymarket_cancel_order	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=true for safe exploration
• API 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:e2e

Related

• @c0pilot/openclaw-polymarket - OpenClaw plugin using this library
• GitHub

License

MIT