Heisenberg Market Intelligence MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add --transport sse -H "Authorization: Bearer YOUR_API_KEY" heisenberg-market-intelligence https://narrative.agent.heisenberg.so/sse
Required:Authorization
README.md

The most comprehensive prediction market intelligence layer for AI agents.

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:


Get Access

  1. Register at cook.heisenberg.so
  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


License

MIT — see LICENSE

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.so

Configuration

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

Try it

Show me the top wallets on Polymarket right now using the Heisenberg Score, filtered for Elite tier with a minimum 45% win rate.
Find active prediction markets about the Federal Reserve with over $100K volume and show me their liquidity and whale concentration.
What's the social pulse on Bitcoin and crypto regulation over the last 48 hours? Show me tweet volume and sentiment signals.
Get the Heisenberg leaderboard, profile the top 3 wallets with Wallet 360 on a 15-day window, then show me their recent trades.
Get candlestick data for the Trump 2024 market at 1h intervals for the last 7 days and describe the price trend.

Frequently Asked Questions

What are the key features of Heisenberg Market Intelligence?

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..

What can I use Heisenberg Market Intelligence for?

Identifying 'smart money' traders in prediction markets to inform research.. Conducting deep-dive research on specific political or economic prediction markets.. Tracking social media narratives and sentiment shifts regarding crypto regulation.. Comparing market liquidity and pricing across different prediction platforms.. Analyzing historical trade performance and PnL of specific high-performing wallets..

How do I install Heisenberg Market Intelligence?

Install Heisenberg Market Intelligence by running: Add the provided JSON block to your claude_desktop_config.json

What MCP clients work with Heisenberg Market Intelligence?

Heisenberg Market Intelligence works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Heisenberg Market Intelligence docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare