Polymarket MCP

🚀 Polymarket MCP Tool

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

🚀 Quick Start

This is a Model Context Protocol (MCP) tool that enables interaction with Polymarket via Claude Desktop.

✨ Features

• Interact with Polymarket through Claude Desktop.

📦 Installation

Prerequisites

• Claude Desktop App for Mac
• Python 3.8+

Steps

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

📚 Documentation

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

This project is under the MIT license.

🔧 Contributing

Feel free to open issues or submit pull requests.