# polymarket-mcp
🎲 *prediction markets at your fingertips*
mcp server and cli for polymarket. get real-time market data, prices, and search through claude desktop or terminal.
[](https://github.com/ozgureyilmaz/polymarket-mcp/actions)
[](https://github.com/ozgureyilmaz/polymarket-mcp/releases)
[](https://opensource.org/licenses/MIT)
[](https://deepwiki.com/ozgureyilmaz/polymarket-mcp)
## features
real-time data: active markets, trending by volume, current prices.
search: find markets by keyword across questions and descriptions.
multiple interfaces: claude desktop integration + standalone cli.
output formats: json, pretty-printed, or clean tables.
caching: built-in smart caching with auto-retry logic.
## requirements
rust 1.70+ (`curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`)
claude desktop for mcp integration ([download](https://claude.ai/download))
## install
```bash
cargo install --git https://github.com/ozgureyilmaz/polymarket-mcp
```
binary installs to `~/.cargo/bin/polymarket-mcp`.
## setup
configure claude desktop:
edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macos):
```json
{
"mcpServers": {
"polymarket": {
"command": "polymarket-mcp"
}
}
}
```
restart claude desktop.
## usage
### cli
```bash
# trending markets
polymarket-mcp --output table trending --limit 5
# active markets
polymarket-mcp --output table markets --limit 10
# search
polymarket-mcp --output table search "fed" --limit 5
# market details
polymarket-mcp market 601700
# prices
polymarket-mcp prices 601700
```
### with claude
after setup, ask claude:
- "show me trending prediction markets"
- "search for markets about trump"
- "what's the current price on the fed decision market?"
## development
```bash
cargo test
cargo build --release
```
## links
- [issues](https://github.com/ozgureyilmaz/polymarket-mcp/issues)
- [mcp docs](https://modelcontextprotocol.io/docs)
- [polymarket-mcp docs](https://deepwiki.com/ozgureyilmaz/polymarket-mcp)
- [polymarket api](https://docs.polymarket.com)
