# FlashAlpha MCP server

> Connect AI assistants to real-time and historical options market analytics including gamma exposure, dealer positioning, and volatility surfaces.

- Repository: https://github.com/FlashAlpha-lab/flashalpha-mcp
- Page: https://hostedmcp.org/servers/flashalpha-lab/flashalpha-mcp
- Transport: remote
- Stars: 1
- License: MIT
- Latest version: 1.6.3

## Install

### Claude Code

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

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "flashalpha-mcp": {
      "url": "https://lab.flashalpha.com/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

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

### VS Code CLI

```sh
code --add-mcp '{"name":"flashalpha-mcp","type":"http","url":"https://lab.flashalpha.com/mcp"}'
```

### Codex

```sh
codex mcp add flashalpha-mcp --url https://lab.flashalpha.com/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.flashalpha-mcp]
url = "https://lab.flashalpha.com/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http flashalpha-mcp https://lab.flashalpha.com/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (84)

- `get_stock_quote`
- `get_tickers`
- `get_symbols`
- `get_option_chain`
- `get_option_quote`
- `get_account`
- `get_gex`
- `get_dex`
- `get_vex`
- `get_chex`
- `get_levels`
- `get_exposure_summary`
- `get_exposure_sheet`
- `get_term_structure`
- `get_exposure_basket`
- `get_oi_diff`
- `get_narrative`
- `get_max_pain`
- `get_zero_dte`
- `get_surface`
- `get_svi_params`
- `get_volatility`
- `get_advanced_volatility`
- `get_expected_move`
- `get_skew_term`
- `get_spot_vol_correlation`
- `get_realized_vol`
- `get_volatility_forecast`
- `get_liquidity`
- `get_dispersion`
- `get_vix_state`
- `get_universe`
- `get_vrp`
- `get_vrp_history`
- `get_stock_summary`
- `calculate_greeks`
- `solve_iv`
- `calculate_kelly`
- `get_flow_live`
- `get_flow_summary`
- `get_flow_levels`
- `get_flow_signals`
- `get_flow_pin_risk`
- `get_flow_dealer_risk`
- `get_dealer_premium`
- `get_option_flow`
- `get_stock_flow`
- `get_flow_scan`
- `get_zero_dte_flow`
- `flow_anomaly`
- `expiry_positioning`
- `zero_dte`
- `dealer_regime`
- `vol_carry`
- `yield_enhancement`
- `surface_anomaly`
- `skew`
- `term_structure`
- `tail_pricing`
- `sell_window`
- `get_earnings`
- `get_earnings_calendar`
- `get_earnings_screener`
- `post_structure_pnl`
- `post_structure_greeks`
- `post_screener`
- `get_screener_fields`
- `get_historical_gex`
- `get_historical_dex`
- `get_historical_vex`
- `get_historical_chex`
- `get_historical_levels`
- `get_historical_exposure_summary`
- `get_historical_narrative`
- `get_historical_zero_dte`
- `get_historical_max_pain`
- `get_historical_volatility`
- `get_historical_advanced_volatility`
- `get_historical_vrp`
- `get_historical_surface`
- `get_historical_stock_quote`
- `get_historical_option_quote`
- `get_historical_stock_summary`
- `get_historical_coverage`

## FAQ

### What kind of options analytics does FlashAlpha provide?

It provides over 70 tools covering gamma exposure (GEX), delta/vanna/charm exposure, max pain, dealer positioning, IV surfaces, VRP analytics, and 0DTE intraday flow.

### How can I authenticate with the FlashAlpha MCP server?

You can use an apiKey passed as a tool parameter for self-hosted clients like Claude Desktop, or use OAuth 2.1 with PKCE for remote clients like ChatGPT Apps.

### Does FlashAlpha offer historical data for backtesting?

Yes, it provides minute-resolution historical replay dating back to April 2018.

### Can I filter tools by specific trading styles?

Yes, the server offers persona-scoped endpoints for styles such as Gamma Exposure, Directional, Premium Seller, 0DTE, and Quant/Systematic.
