# Heisenberg Market Intelligence MCP

> The most comprehensive prediction market intelligence layer for AI agents.
> Polymarket + Kalshi data — wallets, markets, prices, orderbooks, social signals.
> One MCP connection. 13 agents. No infrastructure required.

## Quick Connect

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "heisenberg": {
      "type": "sse",
      "url": "https://narrative.agent.heisenberg.so/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Get your API key → [cook.heisenberg.so](https://cook.heisenberg.so/?auth=signup)

---

## What You Can Build

### Find the smart money
> "Show me the top wallets on Polymarket right now using the Heisenberg
> Score — filter for Elite tier, minimum 45% win rate, upward trajectory"

### Research any market
> "Find active prediction markets about the Federal Reserve with over
> $100K volume and show me their liquidity and whale concentration"

### Track social narratives
> "What's the social pulse on Bitcoin and crypto regulation over
> the last 48 hours? Show me tweet volume and sentiment signals"

### Copy-trade research workflow
> "Get the Heisenberg leaderboard, profile the top 3 wallets with
> Wallet 360 on a 15-day window, then show me their recent trades"

### Cross-platform intelligence
> "Find markets about the next Fed rate decision on both Polymarket
> and Kalshi, compare their prices and recent trade activity"

### Price & orderbook analysis
> "Get candlestick data for the Trump 2024 market at 1h intervals
> for the last 7 days and describe the price trend"

---

## Available Agents

| ID | Agent | Category | Description |
|----|-------|----------|-------------|
| 574 | Polymarket Markets | Market Discovery | Search and filter markets, get token IDs |
| 565 | Kalshi Markets | Market Discovery | Search Kalshi markets, get tickers |
| 575 | Market Insights | Market Discovery | Liquidity, whale concentration, volume trends |
| 568 | Candlesticks | Price & Orderbook | OHLC price history for any outcome token |
| 572 | Orderbook | Price & Orderbook | Historical bid/ask depth snapshots |
| 556 | Polymarket Trades | Trade Intelligence | Trade-level execution data |
| 573 | Kalshi Trades | Trade Intelligence | Trade-level data for Kalshi markets |
| 584 | Heisenberg Leaderboard | Wallet Intelligence | H-Score ranked wallets — filters bots and lucky streaks |
| 579 | Polymarket Leaderboard | Wallet Intelligence | Raw PnL rankings by time window |
| 581 | Wallet 360 | Wallet Intelligence | 60+ metric deep profile per wallet |
| 586 | Wallet Stats | Wallet Intelligence | Quick all-time performance snapshot |
| 569 | PnL | Wallet Intelligence | Time-series realized P&L per wallet |
| 585 | Social Pulse | Social | Social signal volume and sentiment by keyword |

Full parameter reference → [docs/agents_reference.md](docs/agents_reference.md)

---

## Example Workflows

See the `/examples` folder for ready-to-use Claude prompt sequences:

- [Copy-trade research](examples/01_copy_trade_research.md)
- [Market research](examples/02_market_research.md)
- [Social pulse analysis](examples/03_social_pulse.md)
- [Kalshi ↔ Polymarket cross-platform](examples/04_cross_platform_kalshi_polymarket.md)
- [Wallet deep dive](examples/05_wallet_deep_dive.md)

---

## Get Access

1. Register at [cook.heisenberg.so](https://cook.heisenberg.so/?auth=signup)
2. Copy your API key
3. Add the config block above to Claude Desktop
4. Start your first query

Questions or feedback → [open an issue](https://github.com/heisenberg-market-intelligence/heisenberg-mcp/issues)

---

## License

MIT — see [LICENSE](LICENSE)