Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Predictive MarketFind arbitrage opportunities in crypto markets"
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.
What is this?
An MCP (Model Context Protocol) server that aggregates prediction market data from 5 major platforms. Search markets, compare odds, detect arbitrage opportunities, and track predictions through natural language.
Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.
Part of the
Quick Start
# Clone and install
git clone https://github.com/EricGrill/mcp-predictive-market.git
cd mcp-predictive-market
uv sync
# Run the server
uv run python -m mcp_predictive_market.serverAdd to your Claude config and start querying markets:
"Find prediction markets about AI regulation"
Why Use This?
Feature | Description |
Multi-Platform Search | Query 5 prediction markets simultaneously |
Arbitrage Detection | Find price discrepancies across platforms |
Market Tracking | Build watchlists and monitor odds changes |
Platform Comparison | Side-by-side odds for similar questions |
Unified Data Model | Consistent market schema across all platforms |
Available Tools
Search & Discovery
Tool | Description |
| Search markets across all platforms by keyword |
| Get available market categories |
| Browse markets in a specific category |
Market Data
Tool | Description |
| Get current odds for a specific market |
| Side-by-side comparison of similar markets |
Tracking
Tool | Description |
| Add a market to your watchlist |
| View all tracked markets with current prices |
Analysis
Tool | Description |
| Detect price discrepancies between platforms |
Supported Platforms
Platform | URL | Specialization |
Manifold Markets | Play money, wide variety | |
Polymarket | Crypto, high liquidity | |
Metaculus | Science, long-term forecasts | |
PredictIt | US politics | |
Kalshi | CFTC-regulated, real money |
Configuration
Claude Desktop Setup
Add to your Claude Desktop config:
Platform | Config Path |
macOS |
|
Windows |
|
Linux |
|
{
"mcpServers": {
"prediction-market": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-predictive-market", "python", "-m", "mcp_predictive_market.server"]
}
}
}Claude Code Setup
Add to your project .mcp.json or ~/.config/claude-code/mcp.json:
{
"mcpServers": {
"prediction-market": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-predictive-market", "python", "-m", "mcp_predictive_market.server"]
}
}
}Examples
"Find prediction markets about AI"
"What categories of markets are available?"
"Show me crypto markets on Polymarket"
"Browse politics markets""Get current odds for Manifold market abc123"
"Compare odds for 'Will Bitcoin hit $100k?' across all platforms"
"Show me the probability of a 2024 recession on different platforms""Find arbitrage opportunities with at least 10% spread"
"Are there any markets with significantly different odds across platforms?"
"Show me the biggest price discrepancies right now""Track the Polymarket election market"
"Show all my tracked markets"
"What are the current prices on my watchlist?"Development
# Clone
git clone https://github.com/EricGrill/mcp-predictive-market.git
cd mcp-predictive-market
# Install with dev dependencies
uv sync --extra dev
# Run tests
uv run pytest -v
# Run specific test file
uv run pytest tests/test_integration.py -vProject Structure
src/mcp_predictive_market/
├── server.py # MCP server entry point
├── tools.py # Tool handler implementations
├── schema.py # Unified market data models
├── errors.py # Custom exceptions
├── rate_limiter.py # Per-platform rate limiting
├── adapters/ # Platform-specific adapters
│ ├── base.py # Adapter protocol
│ ├── manifold.py
│ ├── polymarket.py
│ ├── metaculus.py
│ ├── predictit.py
│ └── kalshi.py
├── analysis/ # Market analysis modules
│ ├── matching.py # Cross-platform market matching
│ └── arbitrage.py # Arbitrage detection
└── state/ # State management
└── memvid_client.pyTroubleshooting
Platform API may be rate-limited - wait and retry
Check platform is online: visit the website directly
Some platforms filter certain market types
Lower the
min_spreadparameter (default is 5%)Try broader search terms
Fewer opportunities exist in efficient markets
Verify the market ID format (varies by platform)
Ensure the market hasn't been resolved/closed
Check you're using the correct platform name
Related Projects
Claude Code Plugin Marketplace - Discover more MCP plugins
MCP Proxmox Admin - Manage Proxmox VE through Claude
MCP Memvid State Service - Persistent state for MCP servers
Contributing
Contributions welcome!
Fork the repository
Create feature branch:
git checkout -b feature/my-featureMake changes and test:
uv run pytestCommit:
git commit -m 'Add my feature'Push:
git push origin feature/my-featureOpen a Pull Request
License
MIT