Polymarket

v0.1.2Finance & Fintechstable

polymarket mcp server market discovery and analysis via public APIs; optional authenticated trading and portfolio tools when your wallet derives (or supplies) CLOB L2 credentials polymarket mcp server market discovery and analysis via public APIs; op

mcp-servermcp-serverspolymarketpolymarket-mcp-serverclaude-mcp
Share:
152
Stars
0
Downloads
0
Weekly
0/5

What is Polymarket?

Polymarket is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to polymarket mcp server market discovery and analysis via public apis; optional authenticated trading and portfolio tools when your wallet derives (or supplies) clob l2 credentials polymarket mcp server...

polymarket mcp server market discovery and analysis via public APIs; optional authenticated trading and portfolio tools when your wallet derives (or supplies) CLOB L2 credentials polymarket mcp server market discovery and analysis via public APIs; op

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • polymarket mcp server market discovery and analysis via publ

Use Cases

Discover and analyze prediction markets
Access market data and trading portfolios
Trade on Polymarket CLOB L2 blockchain
whitmorelabs

Maintainer

LicenseMIT License
Languagetypescript
Versionv0.1.2
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y polymarket

PIP

pip install polymarket-trading-mcp

Manual Installation

npx -y polymarket

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Polymarket

The Polymarket MCP server connects AI assistants to Polymarket prediction markets through a Python toolkit that provides both free market discovery and analysis tools (slippage estimation, liquidity scanning, arbitrage detection, crypto price feeds, probability estimation, portfolio risk calculation) and optional authenticated trading capabilities when wallet credentials are supplied. It is ideal for traders, researchers, and quantitative analysts who want Claude to research, analyze, or interact with real-money prediction markets without leaving their AI workflow.

Prerequisites

  • Python 3.10 or higher installed
  • pip for installing the polymarket-trading-mcp package
  • An MCP-compatible client such as Claude Desktop or Cursor
  • A Polymarket-compatible wallet with CLOB L2 credentials for authenticated trading (optional — free tools work without any credentials)
  • A 7-day free trial is available for premium paid tools; paid tier requires purchasing API access
1

Install the polymarket-trading-mcp package

Install via pip into your Python environment. Python 3.10+ is required.

pip install polymarket-trading-mcp
2

Verify the installation

Confirm the polymarket-mcp command is available after installation.

polymarket-mcp --help
3

Test the server in standalone mode

Run the server in SSE mode on the default port 8000 to verify it starts correctly. Free tools (liquidity scanning, slippage estimation, arbitrage detection) work without any configuration.

polymarket-mcp
4

Add the server to your MCP client configuration

Add the polymarket entry to your claude_desktop_config.json. The server exposes both free tools (no credentials needed) and optional paid/trading tools when wallet credentials are configured.

5

Restart your MCP client

Save the config file and restart Claude Desktop. The server exposes tools including estimate_slippage, scan_market_liquidity, find_arbitrage_gaps, get_crypto_price, get_contract_status, estimate_probability, and calculate_portfolio_risk.

Polymarket Examples

Client configuration

Claude Desktop configuration for the Polymarket MCP server using stdio mode. No credentials required for free market analysis tools.

{
  "mcpServers": {
    "polymarket": {
      "command": "polymarket-mcp",
      "args": ["--stdio"]
    }
  }
}

Prompts to try

Use these prompts with Claude after connecting the Polymarket MCP server to research and analyze prediction markets.

- "Scan the liquidity on the 'US Presidential Election 2024' Polymarket contract and tell me the current spread."
- "Estimate the slippage if I buy $5,000 worth of YES shares on the current top Polymarket market."
- "Find any arbitrage gaps between YES and NO prices on active Polymarket contracts."
- "Get the current price of Bitcoin from multiple sources and estimate the probability it ends above $100,000 this month."
- "Calculate the portfolio risk for holding YES positions in three different markets with $1,000 each."

Troubleshooting Polymarket

polymarket-mcp command not found after pip install

Ensure your Python scripts directory is in your PATH. On macOS/Linux run 'pip show polymarket-trading-mcp' to find the install location, then add its bin directory to PATH. Alternatively use 'python -m polymarket_mcp' as the command.

Paid tools return authentication errors or request payment

The premium tools (wallet intelligence, advanced market data) require a paid subscription or are available for a 7-day trial. Free tools like estimate_slippage and scan_market_liquidity work without any credentials.

Server starts but returns no market data

The server uses Polymarket's public CLOB API. Check your internet connection and that Polymarket's API is reachable. If using the SSE mode (polymarket-mcp without --stdio), ensure no firewall blocks outbound HTTPS to the Polymarket API endpoints.

Frequently Asked Questions about Polymarket

What is Polymarket?

Polymarket is a Model Context Protocol (MCP) server that polymarket mcp server market discovery and analysis via public apis; optional authenticated trading and portfolio tools when your wallet derives (or supplies) clob l2 credentials polymarket mcp server market discovery and analysis via public apis; op It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Polymarket?

Install via npm with the command: npx -y polymarket. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Polymarket?

Polymarket works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Polymarket free to use?

Yes, Polymarket is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "polymarket": { "command": "npx", "args": ["-y", "polymarket"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Polymarket?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides