- MCP server
- Gemini CLI
ApexVol MCP server for Gemini CLI
Options data,
in Gemini CLI.
Gemini CLI registers MCP servers with one command or a block in settings.json. Use the hosted server over HTTP and sign in, or the local client with a token.
The hosted server, recommended
Connected with
one URL.
ApexVol runs the server. Gemini CLI signs in to your ApexVol account through the browser, so nothing is installed and no token is copied anywhere.
- Run: gemini mcp add --transport http apexvol https://apexvol.com/mcp-server, or add the block below to ~/.gemini/settings.json.
- Start Gemini CLI and run /mcp auth apexvol. A browser tab opens on apexvol.com.
- Sign in and approve the read-only request. Run /mcp to confirm the 43 tools are listed.
- Ask: where is SPY's gamma flip today?
{
"mcpServers": {
"apexvol": {
"httpUrl": "https://apexvol.com/mcp-server"
}
}
}
Where is SPY's gamma flip today, and which strikes hold the most dealer gamma?
Gemini CLI 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 Gemini CLI 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 Gemini CLI starts apexvol-mcp with the token in its environment.
- Run /mcp inside Gemini CLI to confirm the server is connected.
{
"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.
Which transport does Gemini CLI use for the hosted server?
Streamable HTTP, configured with httpUrl in settings.json or the --transport http flag on gemini mcp add. The sign-in runs through /mcp auth.
Can I scope the server to one project?
Yes. A .gemini/settings.json inside the project holds project-scoped servers; ~/.gemini/settings.json holds the ones available everywhere.
Does Gemini pick the tools by itself?
Yes, when a prompt needs market data, and you can name a tool or a ticker to direct it. /mcp lists every tool with its description.
What does the local client need?
Python 3.10 or newer, the apexvol-mcp package from PyPI, and an API token in the environment. apexvol-mcp --check verifies all three before you touch settings.json.
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 Gemini CLI once and every tool follows the tier of your plan.
Real market data, not a sandbox. See it live on AAPL.