Polymarket MCP Server

A Model Context Protocol (MCP) server that provides access to Polymarket's prediction market APIs.

Authentication

The Polymarket API has three components:

• Gamma API (market/event data): No authentication required
• Data API (user positions/trades): No authentication required
• CLOB API (orderbook/prices): No authentication for public endpoints, API key required for trading

Auth Model: For authenticated operations (order creation, cancellation), API key must be provided with every tool call. The server is stateless and does not store authentication credentials between requests.

MCP Type: Third-party integration (auth required for trading operations only)

Available Tools

Market Data (Gamma API - No Auth)

polymarket_get_markets

Get list of markets from Polymarket.

Arguments:

Argument	Type	Required	Description
limit	integer	❌ No	Maximum markets to return (1-1000, default: 100)
offset	integer	❌ No	Skip N markets for pagination (default: 0)
active	boolean	❌ No	Filter by active status

polymarket_get_market

Get detailed information about a specific market by ID.

Arguments:

Argument	Type	Required	Description
market_id	string	✅ Yes	Market ID to retrieve

polymarket_get_events

Get list of events from Polymarket.

Arguments:

Argument	Type	Required	Description
limit	integer	❌ No	Maximum events to return (1-1000, default: 100)
offset	integer	❌ No	Skip N events for pagination (default: 0)

User Data (Data API - No Auth)

polymarket_get_user_positions

Get user positions by wallet address.

Arguments:

Argument	Type	Required	Description
user_address	string	✅ Yes	Ethereum wallet address to query

polymarket_get_user_trades

Get user trade history by wallet address.

Arguments:

Argument	Type	Required	Description
user_address	string	✅ Yes	Ethereum wallet address to query
limit	integer	❌ No	Maximum trades to return (1-1000, default: 100)
offset	integer	❌ No	Skip N trades for pagination (default: 0)

Orderbook Data (CLOB API - No Auth)

polymarket_get_orderbook

Get orderbook for a specific market.

Arguments:

Argument	Type	Required	Description
market_id	string	✅ Yes	Market ID to get orderbook for

polymarket_get_midpoint

Get midpoint price for a specific market.

Arguments:

Argument	Type	Required	Description
market_id	string	✅ Yes	Market ID to get midpoint for

Trading (CLOB API - Auth Required)

polymarket_create_order

Create a new order on Polymarket.

Arguments:

Argument	Type	Required	Description
api_key	string	✅ Yes	Polymarket API key
market_id	string	✅ Yes	Market ID to place order on
side	string	✅ Yes	'BUY' or 'SELL'
price	float	✅ Yes	Order price in USD
size	float	✅ Yes	Order size (number of shares)
token_id	string	✅ Yes	Token ID for the market outcome

polymarket_cancel_order

Cancel an existing order.

Arguments:

Argument	Type	Required	Description
api_key	string	✅ Yes	Polymarket API key
order_id	string	✅ Yes	ID of the order to cancel

polymarket_get_orders

Get user's orders.

Arguments:

Argument	Type	Required	Description
api_key	string	✅ Yes	Polymarket API key
market_id	string	❌ No	Optional market ID to filter orders

Utility

polymarket_health_check

Check server readiness and basic connectivity.

Arguments: None

Setup

# Clone the repository
git clone <repository-url>
cd cl-mcp-polymarket

# Install dependencies
pip install -r requirements.txt