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.

Connect in two minutes Start a trial, MCP included What to ask once it is connected

The MCP and API come with every paid plan. Each tool follows your plan: Basic covers chains and strategies, Premium adds IV, GEX, flow and screens, Pro adds earnings, risk and the scanners. 7 days free, card required.

44Tools 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 44 tools are listed.
  4. Ask: list AAPL's option expirations, then find the at-the-money (50-delta) call for the next monthly expiry.
Gemini CLI~/.gemini/settings.json
{
  "mcpServers": {
    "apexvol": {
      "httpUrl": "https://apexvol.com/mcp-server"
    }
  }
}
First questionproves the connection
You

List AAPL's option expirations, then find the at-the-money (50-delta) call for the next monthly expiry.

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

44 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
Help and discovery 1 tools
  • help

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 API docs list every Bearer endpoint the tools call, with the whole reference as one Markdown file for your assistant.

Included with
every paid plan.

From $55 a month. Connect Gemini CLI once and every tool follows the tier of your plan.

Start free trial Create a free account

Real market data, not a sandbox. See it live on AAPL.