# Polymarket (unofficial)

> Polymarket (unofficial) is an open-source MCP server for finance and payments. Unofficial MCP server giving AI clients read access to Polymarket and gated trading. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, VS Code, Self-hosted
- **Website:** https://pypi.org/project/mcp-server-polymarket/
- **Repository:** https://github.com/tukorama/mcp-server-polymarket
- **MCP Registry name:** io.github.tukorama/mcp-server-polymarket
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-19

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

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

## Alternatives

- [Vi Assistant by Vultax](https://ai-powered.com/mcp/vi-assistant-by-vultax): Vi Assistant by Vultax is an open-source MCP server for finance and payments.
- [DeFi Funding Arbitrage, Pendle & Prediction Odds MCP](https://ai-powered.com/mcp/defi-funding-arbitrage-pendle-and-prediction-odds-mcp): DeFi Funding Arbitrage, Pendle & Prediction Odds MCP is an open-source MCP server for finance and payments.
- [Poshkan Paper Trading](https://ai-powered.com/mcp/poshkan-paper-trading): Poshkan Paper Trading is a free MCP server for finance and payments.
- [lonestaroracle.xyz](https://ai-powered.com/mcp/lonestaroracle-xyz): lonestaroracle.xyz is a paid MCP server for finance and payments.
- [Finance MCP](https://ai-powered.com/mcp/finance-mcp-3): Finance MCP is an open-source MCP server for finance and payments.
- [Universal Blockchain MCP](https://ai-powered.com/mcp/universal-blockchain-mcp): Universal Blockchain MCP is an open-source MCP server for finance and payments.
- [Capital.com MCP Server](https://ai-powered.com/mcp/capital-com-mcp-server): Capital.com MCP Server is an open-source MCP server for finance and payments.
- [Crypto Perps Pulse MCP](https://ai-powered.com/mcp/crypto-perps-pulse-mcp): Crypto Perps Pulse MCP is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/polymarket-unofficial
