About Prediction Market Intelligence MCP
Prediction-market data MCP server for AI agents researching Polymarket and Kalshi. It combines market, trade, price, orderbook, wallet, and social signals across 13 specialized agents.
Key features
- 01Search Polymarket and Kalshi markets
- 02Inspect liquidity and whale concentration
- 03Analyze candlesticks and orderbooks
- 04Review trades and wallet metrics
- 05Track social volume and sentiment
Use cases
- 01Find and compare markets across platforms
- 02Research wallet performance and recent trades
- 03Monitor social signals around a keyword
- 04Study market price and orderbook history
MCP support
Exposes 13 specialized agents’ prediction-market intelligence through one MCP connection. The README shows an SSE endpoint requiring a bearer API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://narrative.agent.heisenberg.so/sseclaude mcp add --transport sse prediction-market-intelligence https://narrative.agent.heisenberg.so/sse{"mcpServers":{"prediction-market-intelligence":{"type":"sse","url":"https://narrative.agent.heisenberg.so/sse"}}}Open in Cursor{"servers":{"prediction-market-intelligence":{"type":"sse","url":"https://narrative.agent.heisenberg.so/sse"}}}Open in VS Code{"mcpServers":{"prediction-market-intelligence":{"type":"sse","url":"https://narrative.agent.heisenberg.so/sse"}}}{"mcpServers":{"prediction-market-intelligence":{"serverUrl":"https://narrative.agent.heisenberg.so/sse"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://narrative.agent.heisenberg.so/sseAuth requiredTools
Details
From the project READMEHeisenberg 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.