1. MCP server
  2. 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.

43Tools Gemini CLI can call
1URL to paste, read-only
0Tokens to copy on the hosted path

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.

  1. Run: gemini mcp add --transport http apexvol https://apexvol.com/mcp-server, or add the block below to ~/.gemini/settings.json.
  2. Start Gemini CLI and run /mcp auth apexvol. A browser tab opens on apexvol.com.
  3. Sign in and approve the read-only request. Run /mcp to confirm the 43 tools are listed.
  4. Ask: where is SPY's gamma flip today?
Gemini CLI~/.gemini/settings.json
{
  "mcpServers": {
    "apexvol": {
      "httpUrl": "https://apexvol.com/mcp-server"
    }
  }
}
First questionproves the connection
You

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.

  1. Install the client: pipx install apexvol-mcp (plain pip works too). Python 3.10 or newer.
  2. Create a token under Account, then API Access. It starts with avmcp_ and is shown once.
  3. Check it before touching any config: APEXVOL_API_TOKEN=avmcp_... apexvol-mcp --check prints the version, the auth result and your remaining budget.
  4. Use the block below instead so Gemini CLI starts apexvol-mcp with the token in its environment.
  5. Run /mcp inside Gemini CLI to confirm the server is connected.
~/.gemini/settings.jsontoken in the environment, never in a prompt
{
  "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.

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.

7 days free, cancel anytime Card required · no charge for 7 days
Start trial →