Polymarket MCP Tool

A Model Context Protocol (MCP) tool for interacting with Polymarket through Claude Desktop.

Prerequisites

• Claude Desktop App for Mac

• Python 3.8+

Related MCP server: AKShare MCP Server

Installation

1. Clone this repository:

git clone https://github.com/fernandezpablo85/polymarket-mcp.git
cd polymarket-mcp

2. Install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Install dependencies:

uv sync

Configure Claude Desktop

1. Open Claude Desktop configuration directory:

open ~/Library/Application\ Support/Claude

2. Create or edit claude_desktop_config.json:

touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. Add the following configuration:

{
  "mcpServers": {
    "polymarket": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/YOUR_USERNAME/projects/polymarket-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Replace YOUR_USERNAME with your actual macOS username.

Usage

Invoke the tool via Claude Desktop.

Troubleshooting

• If tools don't appear in Claude Desktop:

  • Verify your claude_desktop_config.json is correct

  • Restart Claude Desktop

  • Check your Python path and dependencies

• If authentication fails:

  • Verify your .env file has correct credentials

  • Check Polymarket API status

License

MIT

Contributing

Feel free to open issues or submit pull requests.