Trading Volatility MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port for HTTP transport (default: '8000'). | |
| TV_API_KEY | No | Your Trading Volatility API key. Optional; demo mode works with limited tickers. | |
| TV_MCP_TRANSPORT | No | Transport mode: 'stdio' (default) or 'http'. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| server_infoB | Basic information about this MCP server. |
| get_auth_statusA | Check how the Trading Volatility MCP is authenticated for this session. Returns mode='keyed' when an API key is present (full access), or mode='demo' when no key is set (only the demo tickers are available). Does not reveal the key. |
| get_ticker_stateA | Get the canonical compact state snapshot for a ticker — the default starting point for analysis (price, gamma regime, IV rank, key positioning metrics). Optional |
| explain_tickerA | Get a deterministic narrative interpretation of a ticker's current regime and positioning — a plain-language read of the state. Optional |
| get_market_structureA | Get the assembled market-structure interpretation for a ticker: headline signal, regime classification, expected behavior, key levels, and supporting metrics. Optional |
| get_signalsC | Get the current signals for a ticker (active setup/positioning signals). |
| get_levelsA | Get key price levels for a ticker (gamma flip, walls, max pain, expected-move bounds). Optional |
| get_seriesA | Get a historical daily time series for a ticker, for charting and regime context. |
| get_gamma_curveA | Get the gamma strike curve (net gamma per strike) for a ticker. |
| get_gamma_by_expirationA | Get the strike-aligned gamma decomposition by expiration bucket for a ticker (combined, nearest, first_weekly, first_monthly, all_other_expiries). |
| get_gex_by_strikeA | Get the net GEX (gamma exposure) strike curve for a ticker, with call/put contributions — identifies key strikes and call-vs-put dominance. |
| get_options_volumeA | Get real-time options volume aggregated by strike for a ticker and a specific expiration. |
| rank_top_setupsA | Rank trade setups across all tickers by opportunity score (descending) to discover opportunities. Filters (all optional, AND'd): |
| run_screenerA | Run a named screener preset over the cross-ticker ranking. |
| rank_income_setupsA | Rank single-leg income setups (covered calls and cash-secured puts) across all tickers by an IVR-led, regime-guarded income-fit score (descending). Each ticker may surface as both a CC and a CSP candidate, each with a 1-sigma suggested strike, estimated premium, annualized yield, assignment/cap price, and breakeven. Filters (all optional): |
| get_trade_setupA | Get the compact agent-oriented trade setup for a ticker: market state plus a deterministic trade recommendation (regime, bias, opportunity score/tier, trade type, direction, structures, entry/stop/target framing, and caution flags). |
| list_capabilitiesA | Return the Trading Volatility v2 capability manifest (the /llm-spec): the full list of endpoints, metrics, parameters, and conventions. Call this first to self-orient — to discover which metrics, expirations, regimes, and screeners are available before making other calls. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Trading Volatility v2 capability manifest | The /llm-spec manifest: endpoints, metrics, parameters, and conventions. |
TDQS
Scored across 17 tools
Several tools target the same ticker and provide overlapping market-state information (get_ticker_state, get_market_structure, get_trade_setup, explain_ticker). While each has a distinct output format, the boundaries are not immediately clear from names alone. Gamma curve and GEX curve tools also overlap conceptually.
All tools use snake_case with verb-first names (get_, rank_, run_, explain_, list_), and server_info is the only exception but still follows a predictable pattern. Very consistent and easy to parse.
17 tools is on the heavy side but justifiable for a comprehensive volatility analytics API covering per-ticker analysis, cross-ticker ranking, screeners, and income setups. The count is slightly above the ideal range but not bloated.
The server covers a wide range of analysis needs: state snapshots, narratives, signals, levels, historical series, gamma/GEX curves, options volume, rankings, screeners, and trade setups. Minor gaps like open interest or an IV surface exist, but they are not critical for its stated purpose.