Polymarket

HTTPv1.0.0Credential RequiredApr 5, 2026

Documentation

Guide

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

`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

Connect

Get connection URL

https://gateway.mewcp.com/polymarket/mcp

Request Builder

import asyncio
from fastmcp import Client

# Real MewCP gateway URL for this server
GATEWAY_URL = "https://gateway.mewcp.com/polymarket/mcp"
API_KEY = "YOUR_API_KEY"

headers={
    "Authorization": f"Bearer {API_KEY}"
}

async def main():
    
    client = Client(GATEWAY_URL, headers=headers)
    
    async with client:
        # Test the connection by pinging the server
        await client.ping()
        
        # List available operations
        tools = await client.list_tools()
        resources = await client.list_resources()
        prompts = await client.list_prompts()

        # Execute operations
        result = await client.call_tool("example_tool", {"param": "value"})
        print(result)

asyncio.run(main())