Prediction-Market Intelligence MCP Server

Scanna for AI assistants — one server, every IDE.

Drop one config line into your AI assistant. Get ML probabilities, divergence detection, whale analysis, and cross-venue arbitrage across 20,000+ Polymarket and Kalshi markets — live from api.scanna.xyz.

QUICKSTART

Set up in under a minute.

Your AI client — your config snippet. Pick your IDE, paste, restart.

Step 1 — in your terminal
claude mcp add --transport http scanna https://mcp.scanna.xyz/mcp \
  --header "x-api-key=YOUR_SCANNA_API_KEY"
Step 2 — verify
Ask Claude: “List Scanna’s tools”
→ the ping tool is live today; M2 ships the data tools (get_markets,
   get_market_intel, scan_divergence, analyze_wallet, get_history).
Step 1 — open the config file
~/Library/Application Support/Claude/claude_desktop_config.json   (macOS)
%APPDATA%\Claude\claude_desktop_config.json                       (Windows)
Step 2 — paste this config, then restart Claude Desktop
{
  "mcpServers": {
    "scanna": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.scanna.xyz/mcp",
               "--header", "x-api-key:YOUR_SCANNA_API_KEY"]
    }
  }
}
Step 1 — open MCP settings
Cmd / Ctrl + Shift + P  →  Cursor Settings  →  MCP  →  Add new global MCP server
Step 2 — paste this config
{
  "mcpServers": {
    "scanna": {
      "url": "https://mcp.scanna.xyz/mcp",
      "headers": { "x-api-key": "YOUR_SCANNA_API_KEY" }
    }
  }
}
Step 1 — open the Windsurf MCP config
Settings  →  Cascade  →  Model Context Protocol  →  Add Server
Step 2 — paste this config
{
  "mcpServers": {
    "scanna": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.scanna.xyz/mcp",
               "--header", "x-api-key:YOUR_SCANNA_API_KEY"]
    }
  }
}
Step 1 — open the user MCP config
Cmd / Ctrl + Shift + P  →  MCP: Open User Configuration
Step 2 — paste this config
{
  "servers": {
    "scanna": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.scanna.xyz/mcp",
               "--header", "x-api-key:YOUR_SCANNA_API_KEY"]
    }
  }
}
Coming soon
The ChatGPT App ships once the OpenAI Apps SDK reaches GA.
Today: use Claude Code, Claude Desktop, Cursor, Windsurf, or VS Code. Same server URL.

TOOLS

Seven tools, one keystroke away.

Built for prompts, not endpoints. Each tool wraps multiple Scanna API calls into one intent-aligned answer.

ping Live

Round-trip and auth check. Confirms the server is reachable and your API key is being received correctly.

get_markets Coming in M2

Browse and filter active prediction markets by heat, liquidity, category, and risk grade. Wraps /hot, /heat, /risk-score.

get_market_intel Coming in M2

One-call deep dive on a single market — ML probability versus market consensus plus the 6-factor signal stack.

scan_divergence Coming in M2

Find markets where Scanna disagrees with consensus by ≥ X percentage points, or where cross-venue arbitrage exists.

analyze_wallet Coming in M2

Wallet-level reputation: insider risk score, entity-cluster membership, and smart-money labels.

get_history Coming in M2

Time-series and backtest export for any market or wallet — 22 ML features plus the outcome label.

find_convergence Flagship · M3

Three-way probability comparison across Polymarket, Kalshi, and Hyperliquid HyperCore-perp-implied. The differentiator no competitor ships in 2026.

EXAMPLES

What you can ask, once it’s wired.

These prompts route to the right tool automatically. ping is live today — the data tools land in M2.

“What’s hot on Polymarket today?”

Routes to get_markets

“Is the BTC $100K end-of-2026 market mispriced?”

Routes to get_market_intel

“Where is Scanna disagreeing with the crowd by 15+ pp right now?”

Routes to scan_divergence

“Analyze wallet 0xabc… — insider or smart money?”

Routes to analyze_wallet

“Find convergence on Trump 2028 across Polymarket, Kalshi, and HyperCore.”

Routes to find_convergence

“Export the last 30 days of features for the BTC halving market.”

Routes to get_history

ONE SERVER, EVERY ASSISTANT

Wire it once. Use it everywhere.

Get a key in two minutes. Drop one snippet into your IDE’s MCP config. Done.