QuantWheelQuantWheelDocs
DocsMCPMCP Server

MCP Server

Give Claude, Cursor or any MCP-capable agent direct access to your QuantWheel data: GEX, flow, the screener, your journal and active wheels.

Add to Claude

In Claude (web or desktop):

  • Click + in the chat input, then Add connectors → Add custom connector
  • Name: QuantWheel
  • Remote MCP server URL: https://quantwheel.com/api/mcp
  • Click Add - Claude opens the QuantWheel sign-in (OAuth), so no API key is needed

Cursor & other clients

The server speaks Streamable HTTP at https://quantwheel.com/api/mcp and accepts two forms of auth: the OAuth flow (clients that support it, like Claude), or your qw_live_ API key as a Bearer header for mcp.json-configured clients and SDK scripts:

mcp.json
{
  "mcpServers": {
    "quantwheel": {
      "url": "https://quantwheel.com/api/mcp",
      "headers": {
        "Authorization": "Bearer qw_live_YOUR_KEY"
      }
    }
  }
}

Available tools

All tools are read-only and scoped to the authenticated account.

ToolWhat agents use it for
get_gexPut wall, call wall, gamma flip and net gamma for a ticker + expiration.
get_gex_heatmapPer-expiration GEX heatmap with aggregated levels (expensive).
get_gamma_flip_eventsRecent gamma-flip and wall-movement events across tickers.
get_vanna_charmSecond-order greeks in tactical (0-45 DTE) and regime (46-180) buckets with key levels.
get_max_painMax pain strike for a ticker and expiration.
get_option_expirations / get_stock_quotePlumbing: valid dates and spot prices.
find_options_to_sellThe full screener: strategies, derived filters, financials, technicals.
get_flow_bars / get_flow_tradesDollar flow bars and significant prints (sweeps, blocks, whales).
get_journal_performance / get_journal_summary_stats / get_all_time_performanceYour journal P&L by period, year and all-time per ticker.
get_active_wheelsYour wheel portfolio with cost basis, premium collected and P&L.
get_suggested_actionsRolls to consider, covered calls to sell, risk alerts (Pro).
get_wheel_strategyYour active wheel strategy preset: entry filters and roll criteria.

Example session

Because the tools compose, one question fans out into the same calls you would have scripted by hand.

agent transcript
You: How are my wheels doing, and is anything at assignment risk
     into next week?

Agent: [get_active_wheels] -> 4 wheels
       [get_gex ticker=NVDA] [get_option_expirations ticker=NVDA]

       Your 4 wheels are up $1,840 combined this cycle ($735 premium
       collected on NVDA alone). One flag: the NVDA 125C expiring
       Aug 15 is 2.1% ITM and dealers are short gamma below 122.
       Want roll candidates? [find_options_to_sell]

Security & limits

Read-only by design
Every MCP tool is read-only - no orders can be placed through MCP. Calls are rate limited per user (60/min global, tighter on heavy tools like the heatmap) and run with your plan's normal gating: features your plan does not include return an upgrade hint instead of data.
Previous
AI Explanations