polymarket

The polymarket MCP server provides real-time data for Polymarket prediction markets and exposes a CLI for querying trending markets, active markets, searches, and market-specific data such as prices. It also supports integration with Claude Desktop for invoking commands via natural language. After starting the server, you can repeatedly fetch structured data in table, JSON, or pretty formats using the provided commands. Use the standalone CLI to explore markets, or connect Claude Desktop to issue natural language prompts that map to the same underlying commands.

Common CLI workflows include listing trending markets, viewing active markets, and performing keyword searches. Examples include requesting the top trending markets in a compact table, listing active markets with a limit, or searching for markets by a keyword. You can also retrieve detailed information for a specific market by its ID and fetch current price data for that market. When integrated with Claude Desktop, you can say things like: “show me trending prediction markets” or “what's the current price on the fed decision market?” and Claude will route those prompts to the corresponding polymarket-mcp commands.

Prerequisites:

• Rust toolchain (cargo) installed. The README suggests rust 1.70+ and provides a rustup command to install Rust.
• internet access to fetch crates and build the binary.

Install steps:

1. Install the MCP server binary from GitHub: cargo install --git https://github.com/ozgureyilmaz/polymarket-mcp
2. Ensure the binary is in your PATH (the README notes the binary installs to ~/.cargo/bin/polymarket-mcp).
3. Verify installation: polymarket-mcp --help

Usage after installation:

• Run the server/CLI directly to fetch data and format output according to your needs.

Notes and tips:

• Output formats can be JSON, pretty-printed, or tabular tables; specify via --output when invoking the CLI.
• The tool is designed to work with Claude Desktop integration; you can configure Claude to point to the polymarket MCP endpoint (see the config example in the README).
• If you customize the Claude config, ensure the command path polymarket-mcp is correctly referenced, for example in ~/Library/Application Support/Claude/claude_desktop_config.json on macOS.
• The README mentions built-in caching with auto-retry logic; consider appropriate retry/backoff strategies for flaky network conditions.
• If you encounter issues, check that your Rust toolchain is up to date and that the polymarket-mcp binary is executable and accessible from your shell.