{
  "schema_version": "2025-06-18",
  "name": "trading-volatility",
  "display_name": "Trading Volatility",
  "description": "Options market-structure intelligence for equities and ETFs. Deterministic, machine-readable views of dealer gamma (GEX), gamma flip levels, positioning, volatility skew, max pain, key levels, time series, and ranked trade setups — wrapping the Trading Volatility v2 API.",
  "version": "0.1.0",
  "vendor": {
    "name": "Trading Volatility",
    "url": "https://stocks.tradingvolatility.net"
  },
  "documentation_url": "https://stocks.tradingvolatility.net/AGENTS.md",
  "icon_url": "https://stocks.tradingvolatility.net/assets/img/TV_logo.png",
  "remotes": [
    {
      "transport": "streamable-http",
      "url": "https://tv-mcp-avhwfkn5gq-uc.a.run.app/mcp"
    }
  ],
  "endpoint": {
    "url": "https://tv-mcp-avhwfkn5gq-uc.a.run.app/mcp",
    "transport": "streamable-http",
    "health": "https://tv-mcp-avhwfkn5gq-uc.a.run.app/health"
  },
  "authentication": {
    "type": "http_bearer",
    "description": "Forward your Trading Volatility API key as 'Authorization: Bearer <key>'. A demo subset (AAPL, VIX, KO, META, AMZN, XOM, GM, MCD) is callable without a key. Keys are issued on subscription at https://stocks.tradingvolatility.net/api/v2/docs.",
    "instructions_url": "https://stocks.tradingvolatility.net/AGENTS.md"
  },
  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": false
  },
  "tools": [
    {"name": "server_info", "description": "Basic information about this MCP server."},
    {"name": "get_auth_status", "description": "Report whether the current request is authenticated and which access tier / demo mode applies."},
    {"name": "get_ticker_state", "description": "Canonical normalized market-state snapshot for a ticker. The default starting point."},
    {"name": "explain_ticker", "description": "Deterministic plain-English read of the current regime and positioning."},
    {"name": "get_market_structure", "description": "Assembled market-structure interpretation: headline, bias, regime, key levels, drivers, expected behavior."},
    {"name": "get_signals", "description": "Current active setup/positioning signals for a ticker."},
    {"name": "get_levels", "description": "Key price levels for chart overlays or exported level lists."},
    {"name": "get_series", "description": "Historical time series for selected metrics (params: metrics, window)."},
    {"name": "get_gamma_curve", "description": "Net dealer gamma per strike (param: exp, optional realtime)."},
    {"name": "get_gamma_by_expiration", "description": "Strike-aligned gamma decomposition by expiration bucket."},
    {"name": "get_gex_by_strike", "description": "Gamma-exposure (GEX) curve by strike."},
    {"name": "get_options_volume", "description": "Expiration-specific strike-by-strike option volume."},
    {"name": "rank_top_setups", "description": "Rank the ticker universe cross-sectionally by opportunity score."},
    {"name": "run_screener", "description": "Run a named screener preset over the universe."},
    {"name": "get_trade_setup", "description": "Compact agent-oriented trade setup: direction, thesis, risk framing, state labels."},
    {"name": "list_capabilities", "description": "Return the Trading Volatility v2 capability manifest (the /llm-spec)."}
  ],
  "resources": [
    {
      "uri": "tv://llm-spec",
      "name": "Trading Volatility LLM Spec",
      "description": "The /llm-spec manifest: endpoints, metrics, parameters, and conventions.",
      "mimeType": "application/json"
    }
  ],
  "links": {
    "openapi": "https://stocks.tradingvolatility.net/openapi.json",
    "llm_spec": "https://stocks.tradingvolatility.net/api/v2/llm-spec",
    "agents_md": "https://stocks.tradingvolatility.net/AGENTS.md",
    "llms_txt": "https://stocks.tradingvolatility.net/llms.txt",
    "docs": "https://stocks.tradingvolatility.net/api/v2/docs",
    "example_app": "https://github.com/jwolberg/volscan"
  }
}