Metadata-Version: 2.4
Name: prediction-hunt-mcp
Version: 0.1.0
Summary: MCP server for querying Prediction Hunt — live prices, cross-platform matches, arbitrage, and +EV signals across Kalshi, Polymarket, PredictIt, ProphetX, and Opinion
Project-URL: Homepage, https://www.predictionhunt.com
Project-URL: Documentation, https://www.predictionhunt.com/api/docs/mcp
Project-URL: Repository, https://github.com/PredictionHunt/prediction_market_aggregator
Project-URL: Issues, https://github.com/PredictionHunt/prediction_market_aggregator/issues
Author-email: Prediction Hunt <api@predictionhunt.com>
License: MIT License
        
        Copyright (c) 2026 Prediction Hunt
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: arbitrage,claude,kalshi,mcp,model-context-protocol,polymarket,prediction-markets,predictit,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# Prediction Hunt MCP Server

Query prediction market data from [Prediction Hunt](https://predictionhunt.com) directly in AI assistants like Claude, Cursor, and Claude Code.

Get prices, events, cross-platform matching, orderbooks, arbitrage, and +EV opportunities across Kalshi, Polymarket, PredictIt, ProphetX, and Opinion.

## Setup

### 1. Get an API key

Sign up at [predictionhunt.com/api/docs](https://predictionhunt.com/api/docs) and generate a free API key.

### 2. Configure your MCP client

#### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

#### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

#### Claude Code

Add to `.claude/settings.json`:

```json
{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

#### Local development (from source)

```json
{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["--from", "/path/to/mcp-server", "prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `search_events` | Search events and markets by text query |
| `list_events` | Browse events with filters (type, tags, date) |
| `list_markets` | Browse individual markets with current prices |
| `match_markets` | Find the same market across platforms by query/slug/ticker |
| `match_markets_by_url` | Find cross-platform matches by pasting a market URL |
| `match_sports_markets` | Get matched sports markets for a given date |
| `get_price_history` | Historical OHLC candles for a market |
| `get_bulk_prices` | Current prices for up to 100 markets at once |
| `get_orderbook` | Live orderbook for a single market |
| `get_unified_orderbook` | Cross-platform combined orderbook |
| `get_arbitrage_opportunities` | Cross-platform arbitrage signals |
| `get_positive_ev` | Positive expected value opportunities |
| `get_api_status` | API health check (no key required) |

## Example Prompts

- "What NBA games have prediction markets today?"
- "Find arbitrage opportunities above 2% ROI"
- "Compare Bitcoin 100k prices across Kalshi and Polymarket"
- "Show me the orderbook for this Kalshi market: KXBTC-25APR04"
- "What are the best +EV bets right now?"

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `PREDICTION_HUNT_API_KEY` | Yes (for most tools) | — | Your API key |
| `PREDICTION_HUNT_API_URL` | No | `https://www.predictionhunt.com/api/v2` | Custom API base URL |

## License

MIT
