Skip to content
MCP server

Polymarket (unofficial)

Unofficial MCP server giving AI clients read access to Polymarket and gated trading

Runs locally
Install

Polymarket (unofficial) is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, VS Code
Runs
Locally
Version
0.1.0
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add mcp-server-polymarket --env POLYMARKET_API_KEY='<POLYMARKET_API_KEY>' --env POLYMARKET_API_SECRET='<POLYMARKET_API_SECRET>' --env POLYMARKET_API_PASSPHRASE='<POLYMARKET_API_PASSPHRASE>' -- uvx mcp-server-polymarket

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-polymarket": {
      "command": "uvx",
      "args": [
        "mcp-server-polymarket"
      ],
      "env": {
        "POLYMARKET_API_KEY": "<POLYMARKET_API_KEY>",
        "POLYMARKET_API_SECRET": "<POLYMARKET_API_SECRET>",
        "POLYMARKET_API_PASSPHRASE": "<POLYMARKET_API_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-polymarket": {
      "command": "uvx",
      "args": [
        "mcp-server-polymarket"
      ],
      "env": {
        "POLYMARKET_API_KEY": "<POLYMARKET_API_KEY>",
        "POLYMARKET_API_SECRET": "<POLYMARKET_API_SECRET>",
        "POLYMARKET_API_PASSPHRASE": "<POLYMARKET_API_PASSPHRASE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server-polymarket": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-polymarket"
      ],
      "env": {
        "POLYMARKET_API_KEY": "<POLYMARKET_API_KEY>",
        "POLYMARKET_API_SECRET": "<POLYMARKET_API_SECRET>",
        "POLYMARKET_API_PASSPHRASE": "<POLYMARKET_API_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-polymarket": {
      "command": "uvx",
      "args": [
        "mcp-server-polymarket"
      ],
      "env": {
        "POLYMARKET_API_KEY": "<POLYMARKET_API_KEY>",
        "POLYMARKET_API_SECRET": "<POLYMARKET_API_SECRET>",
        "POLYMARKET_API_PASSPHRASE": "<POLYMARKET_API_PASSPHRASE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server-polymarket": {
      "command": "uvx",
      "args": [
        "mcp-server-polymarket"
      ],
      "env": {
        "POLYMARKET_API_KEY": "<POLYMARKET_API_KEY>",
        "POLYMARKET_API_SECRET": "<POLYMARKET_API_SECRET>",
        "POLYMARKET_API_PASSPHRASE": "<POLYMARKET_API_PASSPHRASE>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • POLYMARKET_TOOLSETSTool groups to expose, e.g. auto, all, predictions, perps, or auto,+sports,-docs.
  • POLYMARKET_API_KEYCLOB API key for reading your orders and trades. Not needed after `mcp-server-polymarket auth`.
  • POLYMARKET_API_SECRETCLOB API secret.
  • POLYMARKET_API_PASSPHRASECLOB API passphrase.
  • POLYMARKET_ADDRESSSigner address the CLOB API credentials belong to.
  • POLYMARKET_PRIVATE_KEY_FILEFile holding the signing key. Signing needs the `signing` extra.
  • POLYMARKET_WALLET_ADDRESSYour Polymarket wallet (the address shown in your profile). Required for signing.
  • POLYMARKET_ALLOW_TRADINGSet to true to expose order placement and cancellation tools.
  • POLYMARKET_ALLOW_TRANSFERSSet to true to expose deposit, withdrawal and transfer tools.
  • POLYMARKET_MAX_ORDER_USDLargest order value in USD a single tool call may place (default 100).

About Polymarket (unofficial)

The README says this server wraps the Polymarket prediction-market and perpetual-futures APIs so an AI client can look up markets, order books, prices, positions and Perps data. It is built on the Model Context Protocol and also ships as LangChain and LangGraph tools for developers who prefer an in-process setup.

Tools are grouped into toolsets, and anything that can change money is hidden until the user sets environment flags. Orders, wallet transactions and transfers require the user to confirm each action in the client, are checked against per-order and daily USD caps and a price band, and are not retried automatically if the outcome is unclear.

The project is aimed at developers and quantitative users who want an agent to research Polymarket markets, with trading as an opt-in extra. The package is marked as beta, its trading paths are described as tested against recorded responses rather than real funds, and it is not affiliated with Polymarket.

What it does

Market and order book reads
Search events and markets, read quotes, order books and price history without an account.
Perps market data
Query perpetual futures instruments, tickers, candles, funding history and books.
Gated order placement
Order and cancel tools stay hidden until trading is enabled, and each order must be confirmed by the user.
Spending limits
Per-order, daily and per-transfer USD caps plus a price-deviation check guard against accidental spend.
Toolset selection
Choose which tool groups are exposed to keep the model's context small.
LangGraph integration
Use the same tools as plain LangChain tools inside a LangGraph agent with interrupt-based confirmation.

Good for

  • Asking an agent how likely a market outcome is and how deep the order book is
  • Reviewing open positions and profit and loss from a chat client
  • Comparing BTC perpetual funding rates over a recent period
  • Building a LangGraph research agent over Polymarket data
  • Placing small, confirmed test orders from an MCP client when trading is explicitly enabled

Pricing

Open source

Free MIT-licensed package; no paid tier mentioned.

Prices change. Check pypi.org before you buy.

Polymarket (unofficial) FAQ

Do I need an account to read market data?

No. The README says reading markets, books, prices, positions and Perps data needs nothing but uv and the server.

Is trading enabled by default?

No. Trading and transfers are switched off until the user sets the relevant environment variables.

Is this an official Polymarket product?

No. The README and PyPI page state it is unofficial and not affiliated with Polymarket.

Has trading been tested with real funds?

The README says trading paths were tested against recorded responses and SDK test vectors but not with real funds.

Is Polymarket (unofficial) free?

Yes. Polymarket (unofficial) is open source, so you can use and self-host it for free.

How do I add Polymarket (unofficial) to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-polymarket --env POLYMARKET_API_KEY='<POLYMARKET_API_KEY>' --env POLYMARKET_API_SECRET='<POLYMARKET_API_SECRET>' --env POLYMARKET_API_PASSPHRASE='<POLYMARKET_API_PASSPHRASE>' -- uvx mcp-server-polymarket

What are the best alternatives to Polymarket (unofficial)?

The closest alternatives to Polymarket (unofficial) are Vi Assistant by Vultax, DeFi Funding Arbitrage, Pendle & Prediction Odds MCP, Poshkan Paper Trading, lonestaroracle.xyz and Finance MCP.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers