How do I use Polymarket MCP Tool?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Polymarket MCP Tool show me the current odds for the 2024 US presidential election" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Clone this repository:

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

Install uv if you haven't already:

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

Install dependencies:

uv sync

Configure Claude Desktop

Open Claude Desktop configuration directory:

open ~/Library/Application\ Support/Claude

Create or edit claude_desktop_config.json:

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

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