Polymarket

You can query Polymarket data through an MCP server that exposes live odds, market details, price history, and order books to your AI assistant. This enables natural-language style access to market information and enables building smarter, data-aware conversations with your agents.

How to use

You interact with the Polymarket MCP server from an MCP-compatible client by pointing your client at the local or remote server and then issuing the available tools. The server provides a consistent set of actions to list, search, and inspect markets, view price histories, and review order books. Use these actions to explore markets by category, identify trending markets, and fetch detailed market data for analysis. You can chain queries by combining multiple tools in a single session to build informed recommendations for decisions or conversational insights.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Step 1: Clone the MCP server repository.

Step 2: Install dependencies.

Step 3: Build the project.

Step 4: Run the server in production or development mode.

Additional configuration and notes

Configure your MCP client to connect to the Polymarket MCP server via a stdio configuration. The server is intended to be run locally or from a development environment where you supply the absolute path to the built entry point.

Example local configuration snippet you can adapt to your setup.

{
  "mcpServers": {
    "polymarket": {
      "command": "node",
      "args": ["/absolute/path/to/poly-mcp/dist/index.js"]
    }
  }
}

Troubleshooting and tips

If the server does not start, verify that Node.js and npm are installed, that you have installed dependencies, and that the path to dist/index.js is correct. Check for common issues such as missing environment variables or port conflicts if you expose a remote endpoint. For development, use the MCP Inspector to validate tool responses and refine your prompts.

Tools and capabilities

The server exposes a set of practical tools to explore Polymarket data. You can list markets, search by keyword, fetch detailed market information, retrieve event data, filter by category, discover trending markets, and obtain price history and current order books.

Available tools

list_markets

List and paginate through all Polymarket prediction markets with optional filters for active or closed status and pagination.

search_markets

Search markets by keyword matching questions and descriptions with optional filters for active or closed status and pagination.

get_market

Get detailed information about a specific market by its market_id.

get_event

Fetch event details with all related sub-markets grouped together for easy review.

get_events_by_category

Filter markets by a category such as politics, crypto, sports, or world to focus exploration.

list_categories

List all available market categories for filtering and discovery.

get_trending_markets

Discover markets that are currently hot by volume or price movement.

get_price_history

Retrieve historical price/odds data for a given market and outcome.

get_order_book

Return the real-time order book depth showing current bids and asks for a market.