Skip to main content
Glama
unsanction

Polymarket MCP Server

by unsanction

@c0pilot/mcp-polymarket

MCP (Model Context Protocol) server and client library for Polymarket prediction markets.

npm version

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

License

MIT

Install Server
A
license - permissive license
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • A
    license
    -
    quality
    D
    maintenance
    Enables 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.
    25
    10
    MIT
  • A
    license
    B
    quality
    -
    maintenance
    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 books through the Model Context Protocol.
    59
    25
  • A
    license
    -
    quality
    D
    maintenance
    Enables 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

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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