@falconai/mcp-server

Expose Falcon AI Polymarket analytics (markets, events, series, leaderboard, trader stats, order books, price ticks, copy picks) to Claude via the Model Context Protocol.

Install

Published (recommended):

npx @falconai/mcp-server

Local development:

cd packages/falcon-mcp-server
npm install
FALCON_API_KEY=aif_... node index.js

Get an API key at app.falconai.pro → Developer → API Keys.

Claude Desktop configuration

After npm publish:

{
  "mcpServers": {
    "falcon-polymarket": {
      "command": "npx",
      "args": ["-y", "@falconai/mcp-server"],
      "env": {
        "FALCON_API_KEY": "aif_your_key_here",
        "FALCON_API_BASE": "https://api.falconai.pro/api/v1/external/polymarket"
      }
    }
  }
}

Local repo path (before publish):

{
  "mcpServers": {
    "falcon-polymarket": {
      "command": "node",
      "args": ["C:/path/to/FalcanAIPlatform/packages/falcon-mcp-server/index.js"],
      "env": {
        "FALCON_API_KEY": "aif_your_key_here",
        "FALCON_API_BASE": "https://api.falconai.pro/api/v1/external/polymarket"
      }
    }
  }
}

For staging, set FALCON_API_BASE to https://api-test.falconai.bot/api/v1/external/polymarket.

Tools (v0.1.1)

| Tool | Description | |------|-------------| | search_markets | List/search markets (supports event_slug filter) | | get_market | Market detail + snapshot | | list_events | Browse parent events | | get_event | Event detail with nested markets | | list_series | Browse series collections | | get_series | Series detail with child events | | get_leaderboard | Trader rankings | | get_trader_stats | Full wallet profile | | get_recent_trades | Trade feed | | get_copy_picks | Topic-based copy picks | | get_orderbook | Live L2 book | | get_orderbook_history | Stored spread/mid snapshots (tier 2) | | get_price_ticks | Sub-minute CLOB WebSocket ticks (~5s) | | get_api_usage | Quota / usage |

API docs

https://api.falconai.pro/api/docs