- MCP server
- Windsurf
ApexVol MCP server for Windsurf
Options analytics,
in Cascade.
Windsurf's Cascade agent loads MCP servers from mcp_config.json. Point it at the hosted server and sign in, or run the local client with a token.
The hosted server, recommended
Connected with
one URL.
ApexVol runs the server. Windsurf signs in to your ApexVol account through the browser, so nothing is installed and no token is copied anywhere.
- Open Windsurf Settings, then Cascade, then MCP servers, and choose to manage or add a server. The raw config file is ~/.codeium/windsurf/mcp_config.json.
- Add the block below and save. Windsurf lists apexvol with a sign-in prompt.
- Follow it to apexvol.com, sign in and approve the read-only request.
- In Cascade ask: what is the largest options flow in NVDA today?
{
"mcpServers": {
"apexvol": {
"serverUrl": "https://apexvol.com/mcp-server"
}
}
}What is the largest options flow in NVDA today, and does it read bullish or bearish?
Windsurf calls the tool and answers from live data.- Read-only. The connector can read options analytics on your behalf and nothing else. It cannot see billing or change your account.
- Use the apex form of the URL, apexvol.com without www. The www form fails the audience check on purpose.
- Approving creates a token you can see and revoke under Account, then API Access.
The local client, for developers
Or run it
on your machine.
The open-source apexvol-mcp package runs as a small process Windsurf starts for you. It needs Python 3.10 or newer and an API token.
- Install the client: pipx install apexvol-mcp (plain pip works too). Python 3.10 or newer.
- Create a token under Account, then API Access. It starts with avmcp_ and is shown once.
- Check it before touching any config: APEXVOL_API_TOKEN=avmcp_... apexvol-mcp --check prints the version, the auth result and your remaining budget.
- Use the block below instead so Windsurf starts apexvol-mcp itself with the token in its environment.
- Refresh the MCP list in Cascade. The tools appear once the process is up.
{
"mcpServers": {
"apexvol": {
"command": "apexvol-mcp",
"env": { "APEXVOL_API_TOKEN": "avmcp_YOUR_TOKEN" }
}
}
}Tokens are created under Account, then API Access, shown once, and rotate in one click if one ever leaks. The same token calls the REST API from your own code.
What it can do
43 tools,
by data family.
Each family has a page with a real response and the matching REST endpoints.
Options chain 6 tools
- get_options_chain
- get_expirations
- get_options_by_delta
- get_stock_price
- calculate_expected_move
- get_historical_chain
Volatility 7 tools
- get_iv_rank
- get_volatility_cone
- get_volatility_risk_premium
- get_term_structure
- find_iv_opportunities
- get_vix_snapshot
- get_monies_surface
Greeks & GEX 5 tools
- get_gex
- get_charm_exposure
- get_third_order_greeks
- get_greeks_heatmap
- get_cross_index_gex
Options flow 3 tools
- get_options_flow
- get_smart_money_flow
- scan_volatility_arb
Strategy 5 tools
- build_strategy
- analyze_strategy
- optimize_strategy
- simulate_option_chain
- calculate_probability_of_profit
Risk 4 tools
- calculate_portfolio_greeks
- run_scenario_analysis
- generate_stress_tests
- get_hedge_recommendations
Events & screening 5 tools
- get_earnings_calendar
- analyze_earnings_history
- screen_market
- get_market_overview
- get_economic_calendar
Ticker analytics 8 tools
- get_ticker_analytics (skew, dividends, borrow_rate, correlation, hv_regimes, price_context, relative_value, greeks_exposure)
- get_earnings_move_analysis (mispricing, historical_moves, expected_vs_actual, verdict, seasonality, post_drift, iv_crush)
- get_max_pain
- get_volume_profile
- get_zero_dte
- get_orats_cores
- search_tickers
- scan_relative_value
Questions
Before you
paste the URL.
Where is Windsurf's MCP config?
At ~/.codeium/windsurf/mcp_config.json. The Cascade settings panel edits the same file, so either route works.
Does Windsurf support remote MCP servers?
Yes, through the serverUrl form shown above. Servers that need a sign-in prompt for it in the MCP panel.
How many tools can Cascade load?
Windsurf caps the number of active MCP tools across servers. ApexVol exposes 43; if you run several servers, disable the ones you are not using so the cap is not hit.
Will Cascade call the tools automatically?
Yes, when a request needs market data. You can also name the tool or the ticker directly to steer it.
Other clients
Same server,
every MCP client.
- Claude Desktop
- Claude Code
- Cursor
- ChatGPT
- VS Code
- Windsurf
- Gemini CLI
Prefer the long version? The MCP setup guide covers the protocol, and the docs page lists every Bearer endpoint the tools call.
Included with
every paid plan.
From $55 a month. Connect Windsurf once and every tool follows the tier of your plan.
Real market data, not a sandbox. See it live on AAPL.