Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/SeshatLabs/prediction-market-intelligence-mcp
cd prediction-market-intelligence-mcpThen follow the repository README for any remaining dependency or build steps.
Register it in Claude Code
claude mcp add --transport sse -H "Authorization: Bearer YOUR_API_KEY" heisenberg-market-intelligence https://narrative.agent.heisenberg.so/sseReplace any placeholder paths in the command with the real path on your machine.
AuthorizationMake your agent remember this setup
heisenberg-market-intelligence's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Unified access to Polymarket and Kalshi prediction market data.
- Advanced wallet intelligence including H-Score rankings and 60+ metric profiles.
- Social sentiment and signal tracking for specific keywords.
- Historical price and orderbook analysis with candlestick data.
- Cross-platform market comparison and trade-level execution data.
Tools 13
Polymarket MarketsSearch and filter Polymarket markets and get token IDs.Kalshi MarketsSearch Kalshi markets and get tickers.Market InsightsAnalyze liquidity, whale concentration, and volume trends.CandlesticksRetrieve OHLC price history for any outcome token.OrderbookGet historical bid/ask depth snapshots.Polymarket TradesAccess trade-level execution data for Polymarket.Kalshi TradesAccess trade-level data for Kalshi markets.Heisenberg LeaderboardView H-Score ranked wallets with filters for bots and lucky streaks.Polymarket LeaderboardView raw PnL rankings by time window.Wallet 360Get a deep profile of a wallet with 60+ metrics.Wallet StatsGet a quick all-time performance snapshot for a wallet.PnLGet time-series realized P&L per wallet.Social PulseAnalyze social signal volume and sentiment by keyword.Environment Variables
AuthorizationrequiredBearer token API key obtained from cook.heisenberg.soTry it
Original README from SeshatLabs/prediction-market-intelligence-mcp
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:
{
"mcpServers": {
"heisenberg": {
"type": "sse",
"url": "https://narrative.agent.heisenberg.so/sse",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Get your API key → cook.heisenberg.so
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
Example Workflows
See the /examples folder for ready-to-use Claude prompt sequences:
- Copy-trade research
- Market research
- Social pulse analysis
- Kalshi ↔ Polymarket cross-platform
- Wallet deep dive
Get Access
- Register at cook.heisenberg.so
- Copy your API key
- Add the config block above to Claude Desktop
- Start your first query
Questions or feedback → open an issue
License
MIT — see LICENSE