FlashAlpha MCP Server — Real-Time Options Analytics for AI Assistants

Connect Claude, ChatGPT, Cursor, Windsurf, or any MCP-compatible AI assistant to live options market data. 40 tools covering gamma exposure (GEX), delta/vanna/charm exposure, max pain, key dealer-positioning levels, IV surfaces (SVI), VRP analytics, Black-Scholes greeks, Kelly sizing, 0DTE intraday flow, plus minute-resolution historical replay back to April 2018 for backtesting.

What is this repo

Documentation, setup snippets, and server.json metadata for the FlashAlpha remote MCP server. The server itself runs at https://lab.flashalpha.com/mcp (and /mcp-oauth for OAuth-authenticated clients) — its source is not open. Use this repo as a reference for how to wire FlashAlpha into your AI client of choice.

Server URLs

Two endpoints, identical tool catalog, different authentication:

• Transport: Streamable HTTP
• Protocol version: MCP 2025-06-18
• OAuth discovery: https://lab.flashalpha.com/.well-known/oauth-protected-resource (RFC 9728)
• Authorization server: https://flashalpha.com/oauth

Quick Setup (self-hosted clients → /mcp + apiKey)

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "flashalpha": {
      "type": "http",
      "url": "https://lab.flashalpha.com/mcp"
    }
  }
}

Claude Code CLI

claude mcp add flashalpha --transport http https://lab.flashalpha.com/mcp
claude mcp list

Cursor

Settings → MCP → Add server:

{
  "flashalpha": {
    "transport": "http",
    "url": "https://lab.flashalpha.com/mcp"
  }
}

VS Code (Copilot / Continue)

.vscode/mcp.json or user settings:

{
  "servers": {
    "flashalpha": {
      "type": "http",
      "url": "https://lab.flashalpha.com/mcp"
    }
  }
}

Windsurf

Cascade settings → MCP Servers:

{
  "flashalpha": {
    "transport": "http",
    "url": "https://lab.flashalpha.com/mcp"
  }
}

Perplexity (Pro/Max/Enterprise)

Settings → Connectors → + Custom connector → Remote

• URL: https://lab.flashalpha.com/mcp-oauth
• Auth: OAuth (walks the consent flow at flashalpha.com/oauth/login)

Authentication

/mcp (apiKey)

Every tool call takes apiKey as a string parameter. Get a free key at flashalpha.com.

apiKey: "fa_your_key_here"

Key passes per-call rather than in a header so it works uniformly across all MCP clients without transport-level configuration.

/mcp-oauth (Bearer)

OAuth 2.1 + PKCE + Dynamic Client Registration (RFC 7591). The client registers itself, walks the authorization-code + PKCE flow, and presents a Bearer JWT on each request. No apiKey parameter needed — the server resolves the user's account from the OAuth identity and forwards the API key internally for upstream /v1/* calls. Same per-user tier gating and rate limits apply as the apiKey flow.

Discovery + endpoints:

... View full README on GitHub