> ## Documentation Index
> Fetch the complete documentation index at: https://api.polymarketanalytics.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Working with AI

> Connect Falcon to Claude via MCP and query prediction markets in natural language. No code, no API calls — just ask questions and get structured answers instantly.

## Connect Claude via MCP

Add the Heisenberg MCP server so Claude can query Falcon-backed prediction market data in natural language.

> **Claude Pro / Team / Enterprise**
>
> *claude.ai web interface*
>
> 1. Go to **Settings** → **Integrations** → **Add MCP server**
> 2. Paste the server URL below
> 3. Name it **Prediction Market Intelligence**
> 4. Authenticate with your API token on first use
>
> ```text theme={null}
> https://narrative.agent.heisenberg.so/sse
> ```

> **Claude Desktop**
>
> *Free desktop app*
>
> 1. Open a terminal and run the command below
> 2. Follow the prompts to configure your API token
> 3. Restart Claude Desktop — the server appears in **Integrations**
>
> ```bash theme={null}
> npx heisenberg-mcp
> ```

## What you can ask

Example prompts once MCP is connected:

What are the most traded markets on Polymarket right now?
Market Discovery

Show me the top wallets by profit this week
Leaderboards

Analyze wallet 0x1234… — is this a good trader?
Wallet Intelligence

Are there any sharp price moves on the election market?
Anomaly Detection

Compare Polymarket and Kalshi pricing for the Fed decision
Cross-Platform

What is the social sentiment around this market?
Social Intelligence

## Why MCP?

> **Zero code**
>
> No API calls, no JSON parsing, no authentication flow in your editor. Ask questions and get answers.

> **Real-time**
>
> Claude queries Heisenberg live — responses reflect the latest market state.

> **Full access**
>
> Markets, trades, wallets, analytics, and social data — the same surface area as the API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.