Skip to main content
Glama

HubVibe: Pay-per-Call Agent Tools: Web Search, Email Verify, KYC Screening, Stocks, Crypto, News

Trading mathematics: returns, risk, drawdown, VaR, beta, indicators, options, Kelly

hubvibe_finance_analytics
Read-onlyIdempotent

Trading and portfolio math: returns and CAGR, volatility, Sharpe and Sortino, max drawdown, VaR/CVaR, beta, alpha and correlation vs a benchmark, SMA/EMA, RSI, Bollinger bands, Black-Scholes option price with Greeks, and the Kelly fraction, over prices you send or a ticker fetched live. Deterministic, every formula named, no LLM. Input: prices or symbol; optional metrics, benchmark, option, kelly. $0.50 per call.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "hubvibe_finance_analytics"
  }
}

Input Schema

NameRequiredDescriptionDefault
alphaNo
kellyNo
rangeNo
optionNo
pricesNo
symbolNo
metricsNo
windowsNo
languageNo
risk_free_rateNo
benchmark_pricesNo
benchmark_symbolNo
periods_per_yearNo

Output Schema

NameRequiredDescriptionDefault
resultYes
statusYes
workerYes
price_usdYes
receipt_urlYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed27 schema fields changed
    • removedInput schema / properties / alpha / description
      Removed value: -"Tail probability for VaR/CVaR. Default 0.05."
    • removedInput schema / properties / benchmark_prices / description
      Removed value: -"Benchmark series for beta/alpha/correlation, same order as `prices`."
    • changedInput schema / properties / benchmark_prices / items / oneOf
      Previous value: -[
      -  {
      -    "description": "A price.",
      -    "exclusiveMinimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "{date, close}.",
      -    "properties": {
      -      "close": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "date": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "close"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "exclusiveMinimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "close": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "date": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "close"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / benchmark_symbol / description
      Removed value: -"Benchmark fetched live (e.g. SPY) for beta/alpha/correlation."
    • removedInput schema / properties / kelly / description
      Removed value: -"Bet parameters for the Kelly fraction (enables kelly)."
    • removedInput schema / properties / kelly / properties / win_loss_ratio / description
      Removed value: -"Average win / average loss (b in b:1)."
    • removedInput schema / properties / language / description
      Removed value: -"Optional BCP-47 language tag (en, ja, ko, pt-BR): the human-readable strings of the result (notes, details, reasons) are translated into this language; data, codes, numbers and URLs are untouched. Default: as produced."
    • removedInput schema / properties / metrics / description
      Removed value: -"Which results to compute. Default: returns, volatility, sharpe, sortino, drawdown, var, moving_averages, rsi, bollinger, plus beta/black_scholes/kelly when their inputs are given."
    • removedInput schema / properties / option / description
      Removed value: -"European option to price with Black-Scholes-Merton (enables black_scholes)."
    • removedInput schema / properties / option / properties / dividend_yield / description
      Removed value: -"Continuous yield, default 0."
    • removedInput schema / properties / option / properties / rate / description
      Removed value: -"Continuous risk-free rate; default risk_free_rate."
    • removedInput schema / properties / option / properties / spot / description
      Removed value: -"Default: the last price of the series."
    • removedInput schema / properties / option / properties / volatility / description
      Removed value: -"Annual volatility as a fraction; default: the series' annualized log-return volatility."
    • removedInput schema / properties / periods_per_year / description
      Removed value: -"Annualization basis: 252 trading days (default), 12 months, 365 days, 52 weeks."
    • removedInput schema / properties / prices / description
      Removed value: -"Prices oldest first: numbers, or {date, close} objects. Use this OR `symbol`."
    • changedInput schema / properties / prices / items / oneOf
      Previous value: -[
      -  {
      -    "description": "A price.",
      -    "exclusiveMinimum": 0,
      -    "type": "number"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "{date, close}.",
      -    "properties": {
      -      "close": {
      -        "exclusiveMinimum": 0,
      -        "type": "number"
      -      },
      -      "date": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "close"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "exclusiveMinimum": 0,
      +    "type": "number"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "close": {
      +        "exclusiveMinimum": 0,
      +        "type": "number"
      +      },
      +      "date": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "close"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / range / description
      Removed value: -"History range with `symbol`, default 1y."
    • removedInput schema / properties / risk_free_rate / description
      Removed value: -"Annual risk-free rate as a fraction (0.04 = 4%). Default 0."
    • removedInput schema / properties / symbol / description
      Removed value: -"Fetch the series live instead of `prices` (daily closes). Use this OR `prices`."
    • removedInput schema / properties / windows / description
      Removed value: -"Indicator windows. Default sma [20,50,200], ema [12,26], rsi 14, bollinger 20."
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / properties / attribution
      Removed value: -{
      -  "items": {},
      -  "type": "array"
      -}
    • removedOutput schema / properties / billing_warning
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / provenance
      Removed value: -{
      -  "type": "object"
      -}
    • removedOutput schema / properties / receipt_id
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / status / type
      Removed value: -"string"
    • changedOutput schema / required
      Previous value: -[
      -  "status",
      -  "worker",
      -  "price_usd",
      -  "result",
      -  "provenance",
      -  "receipt_id",
      -  "receipt_url"
      -]New value: +[
      +  "status",
      +  "worker",
      +  "price_usd",
      +  "result",
      +  "receipt_url"
      +]
  2. Changed2 schema fields changed
    • addedInput schema / minProperties
      Added value: +1
    • removedInput schema / oneOf
      Removed value: -[
      -  {
      -    "required": [
      -      "prices"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "symbol"
      -    ]
      -  }
      -]
  3. Changed23 schema fields changed
    • removedOutput schema / description
      Removed value: -"The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`."
    • removedOutput schema / properties / attribution / description
      Removed value: -"Present only when the result's text was machine-translated: the credit to show with it."
    • removedOutput schema / properties / attribution / items / description
      Removed value: -"A credit."
    • removedOutput schema / properties / attribution / items / properties
      Removed value: -{
      -  "text": {
      -    "description": "Credit.",
      -    "examples": [
      -      "Translated by Google"
      -    ],
      -    "type": "string"
      -  },
      -  "url": {
      -    "description": "Link.",
      -    "examples": [
      -      "https://translate.google.com"
      -    ],
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / attribution / items / required
      Removed value: -[
      -  "text",
      -  "url"
      -]
    • removedOutput schema / properties / attribution / items / type
      Removed value: -"object"
    • removedOutput schema / properties / billing_warning / description
      Removed value: -"Present only when the charge was recorded with a caveat."
    • removedOutput schema / properties / billing_warning / examples
      Removed value: -[
      -  "settlement pending"
      -]
    • removedOutput schema / properties / price_usd / description
      Removed value: -"What this call cost, in USD."
    • removedOutput schema / properties / price_usd / examples
      Removed value: -[
      -  0.02
      -]
    • removedOutput schema / properties / provenance / description
      Removed value: -"How the result was produced: which providers ran and how long each took."
    • removedOutput schema / properties / provenance / properties
      Removed value: -{
      -  "attempts": {
      -    "description": "Provider attempts made, including retries and failovers.",
      -    "examples": [
      -      1
      -    ],
      -    "type": "integer"
      -  },
      -  "elapsed_ms": {
      -    "description": "Wall-clock milliseconds for the whole job.",
      -    "examples": [
      -      340
      -    ],
      -    "type": "integer"
      -  },
      -  "providers_used": {
      -    "description": "Providers that served the job.",
      -    "examples": [
      -      [
      -        "coinbase-advanced-trade-public"
      -      ]
      -    ],
      -    "items": {
      -      "description": "Provider name.",
      -      "examples": [
      -        "coinbase-advanced-trade-public"
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "steps": {
      -    "description": "Every step the job ran, in order.",
      -    "items": {
      -      "description": "One step of the job.",
      -      "properties": {
      -        "ms": {
      -          "description": "Milliseconds the step took.",
      -          "examples": [
      -            312
      -          ],
      -          "type": "integer"
      -        },
      -        "ok": {
      -          "description": "Whether the step succeeded.",
      -          "examples": [
      -            true
      -          ],
      -          "type": "boolean"
      -        },
      -        "provider": {
      -          "description": "Provider that served the step.",
      -          "examples": [
      -            "coinbase-advanced-trade-public"
      -          ],
      -          "type": "string"
      -        },
      -        "reason": {
      -          "description": "Failure reason, on a failed step.",
      -          "examples": [
      -            "provider_timeout"
      -          ],
      -          "type": "string"
      -        },
      -        "step": {
      -          "description": "Step name inside the worker.",
      -          "examples": [
      -            "quote"
      -          ],
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "ok",
      -        "ms"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  }
      -}
    • removedOutput schema / properties / provenance / required
      Removed value: -[
      -  "steps",
      -  "providers_used",
      -  "attempts",
      -  "elapsed_ms"
      -]
    • removedOutput schema / properties / receipt_id / description
      Removed value: -"Receipt id for this job."
    • removedOutput schema / properties / receipt_id / examples
      Removed value: -[
      -  "rcpt_9f1c2b3a4d5e6f70"
      -]
    • removedOutput schema / properties / receipt_url / description
      Removed value: -"Where to fetch the machine-readable receipt (free, no payment)."
    • removedOutput schema / properties / receipt_url / examples
      Removed value: -[
      -  "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      -]
    • removedOutput schema / properties / result / properties
      Removed value: -{
      -  "as_of": {
      -    "description": "Date or timestamp of the last price (from the dates given or the source).",
      -    "examples": [
      -      "2026-09-25"
      -    ],
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "beta": {
      -    "description": "Against the benchmark; null unless one was given.",
      -    "properties": {
      -      "alpha_annualized": {
      -        "description": "Annualized Jensen's alpha.",
      -        "examples": [
      -          0.31
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "benchmark_annualized_volatility": {
      -        "description": "Benchmark volatility, annualized.",
      -        "examples": [
      -          0.18
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "beta": {
      -        "description": "cov/var vs the benchmark.",
      -        "examples": [
      -          1.12
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "correlation": {
      -        "description": "Pearson correlation of period returns.",
      -        "examples": [
      -          0.83
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "n": {
      -        "description": "Aligned returns used.",
      -        "examples": [
      -          21
      -        ],
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "n",
      -      "beta"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "black_scholes": {
      -    "description": "Black-Scholes-Merton.",
      -    "properties": {
      -      "d1": {
      -        "description": "d1.",
      -        "examples": [
      -          0.11
      -        ],
      -        "type": "number"
      -      },
      -      "d2": {
      -        "description": "d2.",
      -        "examples": [
      -          -0.04
      -        ],
      -        "type": "number"
      -      },
      -      "delta": {
      -        "description": "dV/dS.",
      -        "examples": [
      -          0.54
      -        ],
      -        "type": "number"
      -      },
      -      "gamma": {
      -        "description": "d2V/dS2.",
      -        "examples": [
      -          0.024
      -        ],
      -        "type": "number"
      -      },
      -      "inputs": {
      -        "description": "The inputs used, including any defaulted from the series.",
      -        "properties": {
      -          "dividend_yield": {
      -            "description": "q.",
      -            "examples": [
      -              0
      -            ],
      -            "type": "number"
      -          },
      -          "rate": {
      -            "description": "r.",
      -            "examples": [
      -              0.04
      -            ],
      -            "type": "number"
      -          },
      -          "spot": {
      -            "description": "S.",
      -            "examples": [
      -              120
      -            ],
      -            "type": "number"
      -          },
      -          "strike": {
      -            "description": "K.",
      -            "examples": [
      -              120
      -            ],
      -            "type": "number"
      -          },
      -          "time_to_expiry_years": {
      -            "description": "T.",
      -            "examples": [
      -              0.5
      -            ],
      -            "type": "number"
      -          },
      -          "volatility": {
      -            "description": "sigma.",
      -            "examples": [
      -              0.217
      -            ],
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "spot",
      -          "strike",
      -          "rate",
      -          "volatility",
      -          "time_to_expiry_years",
      -          "dividend_yield"
      -        ],
      -        "type": "object"
      -      },
      -      "price": {
      -        "description": "Option value.",
      -        "examples": [
      -          4.83
      -        ],
      -        "type": "number"
      -      },
      -      "rho": {
      -        "description": "dV/dr per 1.0 of rate.",
      -        "examples": [
      -          29.8
      -        ],
      -        "type": "number"
      -      },
      -      "theta": {
      -        "description": "dV/dt per year.",
      -        "examples": [
      -          -6.9
      -        ],
      -        "type": "number"
      -      },
      -      "type": {
      -        "description": "Option type.",
      -        "enum": [
      -          "call",
      -          "put"
      -        ],
      -        "examples": [
      -          "call"
      -        ],
      -        "type": "string"
      -      },
      -      "vega": {
      -        "description": "dV/dsigma per 1.0 of volatility.",
      -        "examples": [
      -          33.1
      -        ],
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "price",
      -      "delta",
      -      "gamma",
      -      "vega",
      -      "theta",
      -      "rho",
      -      "inputs"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "bollinger": {
      -    "description": "Bollinger bands at the last price.",
      -    "properties": {
      -      "bandwidth": {
      -        "description": "(upper-lower)/middle.",
      -        "examples": [
      -          0.134
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "k": {
      -        "description": "Band width in standard deviations.",
      -        "examples": [
      -          2
      -        ],
      -        "type": "number"
      -      },
      -      "lower": {
      -        "description": "Lower band.",
      -        "examples": [
      -          105.9
      -        ],
      -        "type": "number"
      -      },
      -      "middle": {
      -        "description": "SMA.",
      -        "examples": [
      -          113.5
      -        ],
      -        "type": "number"
      -      },
      -      "percent_b": {
      -        "description": "Where the last price sits in the band (0 lower, 1 upper).",
      -        "examples": [
      -          0.93
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "upper": {
      -        "description": "Upper band.",
      -        "examples": [
      -          121.1
      -        ],
      -        "type": "number"
      -      },
      -      "window": {
      -        "description": "Window.",
      -        "examples": [
      -          20
      -        ],
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "window",
      -      "k",
      -      "middle",
      -      "upper",
      -      "lower"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "checked_at": {
      -    "description": "When this node read the source (UTC). Nothing here is cached.",
      -    "examples": [
      -      "2026-09-26T18:00:00Z"
      -    ],
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "drawdown": {
      -    "description": "Maximum drawdown.",
      -    "properties": {
      -      "duration_periods": {
      -        "description": "Periods from peak to trough.",
      -        "examples": [
      -          1
      -        ],
      -        "type": "integer"
      -      },
      -      "max_drawdown": {
      -        "description": "Largest peak-to-trough fall as a fraction (negative or 0).",
      -        "examples": [
      -          -0.0167
      -        ],
      -        "type": "number"
      -      },
      -      "peak_index": {
      -        "description": "Index of the peak.",
      -        "examples": [
      -          3
      -        ],
      -        "type": "integer"
      -      },
      -      "recovery_index": {
      -        "description": "First index back at the peak; null when not recovered.",
      -        "examples": [
      -          6
      -        ],
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "trough_index": {
      -        "description": "Index of the trough.",
      -        "examples": [
      -          4
      -        ],
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "max_drawdown",
      -      "peak_index",
      -      "trough_index",
      -      "recovery_index",
      -      "duration_periods"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "first_date": {
      -    "description": "First date when dates were given.",
      -    "examples": [
      -      "2026-08-26"
      -    ],
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "kelly": {
      -    "description": "Kelly criterion.",
      -    "properties": {
      -      "bet": {
      -        "description": "Whether the fraction is positive.",
      -        "examples": [
      -          true
      -        ],
      -        "type": "boolean"
      -      },
      -      "fraction": {
      -        "description": "Kelly fraction p - (1-p)/b.",
      -        "examples": [
      -          0.25
      -        ],
      -        "type": "number"
      -      },
      -      "half_kelly": {
      -        "description": "Half Kelly.",
      -        "examples": [
      -          0.125
      -        ],
      -        "type": "number"
      -      },
      -      "win_loss_ratio": {
      -        "description": "b.",
      -        "examples": [
      -          1.5
      -        ],
      -        "type": "number"
      -      },
      -      "win_probability": {
      -        "description": "p.",
      -        "examples": [
      -          0.55
      -        ],
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "win_probability",
      -      "win_loss_ratio",
      -      "fraction",
      -      "half_kelly",
      -      "bet"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "last_date": {
      -    "description": "Last date when dates were given.",
      -    "examples": [
      -      "2026-09-25"
      -    ],
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "method": {
      -    "description": "Every formula used, in words.",
      -    "examples": [
      -      "simple returns p_t/p_{t-1}-1 and log returns..."
      -    ],
      -    "type": "string"
      -  },
      -  "metrics_computed": {
      -    "description": "Metrics present (non-null) in this result.",
      -    "examples": [
      -      [
      -        "returns",
      -        "volatility",
      -        "sharpe"
      -      ]
      -    ],
      -    "items": {
      -      "description": "A metric name.",
      -      "examples": [
      -        "returns"
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "moving_averages": {
      -    "description": "Simple and exponential moving averages at the last price.",
      -    "properties": {
      -      "ema": {
      -        "additionalProperties": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "description": "Value per window, keyed by the window length.",
      -        "examples": [
      -          {
      -            "20": 116.4,
      -            "50": 110.2
      -          }
      -        ],
      -        "properties": {},
      -        "required": [],
      -        "type": "object"
      -      },
      -      "last_price": {
      -        "description": "Last price, for comparison.",
      -        "examples": [
      -          120
      -        ],
      -        "type": "number"
      -      },
      -      "sma": {
      -        "additionalProperties": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "description": "Value per window, keyed by the window length.",
      -        "examples": [
      -          {
      -            "20": 116.4,
      -            "50": 110.2
      -          }
      -        ],
      -        "properties": {},
      -        "required": [],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "sma",
      -      "ema",
      -      "last_price"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "n": {
      -    "description": "Prices in the series.",
      -    "examples": [
      -      22
      -    ],
      -    "type": "integer"
      -  },
      -  "n_returns": {
      -    "description": "Period returns (n - 1).",
      -    "examples": [
      -      21
      -    ],
      -    "type": "integer"
      -  },
      -  "notes": {
      -    "description": "Caveats about undefined or aligned metrics.",
      -    "examples": [
      -      []
      -    ],
      -    "items": {
      -      "description": "A caveat.",
      -      "examples": [
      -        "rsi needs at least 15 prices."
      -      ],
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "periods_per_year": {
      -    "description": "Annualization basis.",
      -    "examples": [
      -      252
      -    ],
      -    "type": "integer"
      -  },
      -  "returns": {
      -    "description": "Return statistics.",
      -    "properties": {
      -      "annualized_mean_return": {
      -        "description": "mean_period_return * periods_per_year.",
      -        "examples": [
      -          2.2
      -        ],
      -        "type": "number"
      -      },
      -      "best_period": {
      -        "description": "Largest period return.",
      -        "examples": [
      -          0.0227
      -        ],
      -        "type": "number"
      -      },
      -      "cagr": {
      -        "description": "Compound annual growth rate over n_returns/periods_per_year years.",
      -        "examples": [
      -          7.9
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "first_price": {
      -        "description": "First price.",
      -        "examples": [
      -          100
      -        ],
      -        "type": "number"
      -      },
      -      "last_price": {
      -        "description": "Last price.",
      -        "examples": [
      -          120
      -        ],
      -        "type": "number"
      -      },
      -      "mean_log_return": {
      -        "description": "Mean log return per period.",
      -        "examples": [
      -          0.0087
      -        ],
      -        "type": "number"
      -      },
      -      "mean_period_return": {
      -        "description": "Mean simple return per period.",
      -        "examples": [
      -          0.0088
      -        ],
      -        "type": "number"
      -      },
      -      "n_returns": {
      -        "description": "Period returns.",
      -        "examples": [
      -          21
      -        ],
      -        "type": "integer"
      -      },
      -      "total_return": {
      -        "description": "last/first - 1.",
      -        "examples": [
      -          0.2
      -        ],
      -        "type": "number"
      -      },
      -      "worst_period": {
      -        "description": "Smallest period return.",
      -        "examples": [
      -          -0.0167
      -        ],
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "n_returns",
      -      "first_price",
      -      "last_price",
      -      "total_return",
      -      "mean_period_return"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "risk_free_rate": {
      -    "description": "Annual risk-free rate used.",
      -    "examples": [
      -      0.04
      -    ],
      -    "type": "number"
      -  },
      -  "rsi": {
      -    "description": "Relative strength index.",
      -    "properties": {
      -      "value": {
      -        "description": "Wilder RSI 0-100; null when too few prices.",
      -        "examples": [
      -          71.2
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "window": {
      -        "description": "Window.",
      -        "examples": [
      -          14
      -        ],
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "window",
      -      "value"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "sharpe": {
      -    "description": "Annualized Sharpe ratio; null when undefined.",
      -    "examples": [
      -      9.8
      -    ],
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "sortino": {
      -    "description": "Annualized Sortino ratio; null when undefined.",
      -    "examples": [
      -      23.6
      -    ],
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "source": {
      -    "description": "Where the series came from.",
      -    "properties": {
      -      "benchmark_n": {
      -        "description": "Benchmark prices used.",
      -        "examples": [
      -          250
      -        ],
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "benchmark_symbol": {
      -        "description": "Benchmark ticker when fetched.",
      -        "examples": [
      -          "SPY"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "provider": {
      -        "description": "Provider that served the series.",
      -        "examples": [
      -          "nasdaq-data-api"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "range": {
      -        "description": "Range fetched, with type symbol.",
      -        "examples": [
      -          "1y"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "symbol": {
      -        "description": "Ticker, with type symbol.",
      -        "examples": [
      -          "AAPL"
      -        ],
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "type": {
      -        "description": "Inline prices or a live-fetched series.",
      -        "enum": [
      -          "prices",
      -          "symbol"
      -        ],
      -        "examples": [
      -          "prices"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  "var": {
      -    "description": "Value at risk, one period.",
      -    "properties": {
      -      "alpha": {
      -        "description": "Tail probability.",
      -        "examples": [
      -          0.05
      -        ],
      -        "type": "number"
      -      },
      -      "historical_cvar": {
      -        "description": "Mean loss beyond the VaR.",
      -        "examples": [
      -          0.0167
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "historical_var": {
      -        "description": "Loss not exceeded with probability 1-alpha, as a positive fraction.",
      -        "examples": [
      -          0.0158
      -        ],
      -        "type": "number"
      -      },
      -      "horizon_periods": {
      -        "description": "Horizon in periods.",
      -        "examples": [
      -          1
      -        ],
      -        "type": "integer"
      -      },
      -      "parametric_var": {
      -        "description": "Normal-model VaR, -(mean + z*std).",
      -        "examples": [
      -          0.0137
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "parametric_z": {
      -        "description": "z at alpha.",
      -        "examples": [
      -          -1.6449
      -        ],
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "alpha",
      -      "horizon_periods",
      -      "historical_var",
      -      "parametric_z"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  },
      -  "volatility": {
      -    "description": "Dispersion of returns.",
      -    "properties": {
      -      "annualized": {
      -        "description": "period_std * sqrt(periods_per_year).",
      -        "examples": [
      -          0.217
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "downside_deviation_annualized": {
      -        "description": "Annualized downside deviation vs the risk-free rate.",
      -        "examples": [
      -          0.09
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "log_return_std": {
      -        "description": "Sample standard deviation of log returns.",
      -        "examples": [
      -          0.0136
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "period_std": {
      -        "description": "Sample standard deviation of period returns.",
      -        "examples": [
      -          0.0137
      -        ],
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "period_std",
      -      "annualized"
      -    ],
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / result / required
      Removed value: -[
      -  "source",
      -  "n",
      -  "n_returns",
      -  "periods_per_year",
      -  "risk_free_rate",
      -  "metrics_computed",
      -  "returns",
      -  "volatility",
      -  "sharpe",
      -  "sortino",
      -  "drawdown",
      -  "var",
      -  "beta",
      -  "moving_averages",
      -  "rsi",
      -  "bollinger",
      -  "black_scholes",
      -  "kelly",
      -  "notes",
      -  "method",
      -  "as_of",
      -  "checked_at"
      -]
    • removedOutput schema / properties / status / description
      Removed value: -"Present only on a delivered result."
    • removedOutput schema / properties / worker / description
      Removed value: -"Catalog name of the worker that ran."
    • removedOutput schema / properties / worker / examples
      Removed value: -[
      -  "market.quote"
      -]
    • removedOutput schema / title
      Removed value: -"finance.analytics response"
  4. Changed1 schema field changed
    • addedOutput schema / properties / attribution
      Added value: +{
      +  "description": "Present only when the result's text was machine-translated: the credit to show with it.",
      +  "items": {
      +    "description": "A credit.",
      +    "properties": {
      +      "text": {
      +        "description": "Credit.",
      +        "examples": [
      +          "Translated by Google"
      +        ],
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Link.",
      +        "examples": [
      +          "https://translate.google.com"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "text",
      +      "url"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  5. Changed1 schema field changed
    • addedInput schema / properties / language
      Added value: +{
      +  "description": "Optional BCP-47 language tag (en, ja, ko, pt-BR): the human-readable strings of the result (notes, details, reasons) are translated into this language; data, codes, numbers and URLs are untouched. Default: as produced.",
      +  "maxLength": 35,
      +  "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
      +  "type": "string"
      +}
  6. Added

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, openWorld for live fetch), so the bar is lower. The description adds genuinely useful facts beyond that: determinism, "every formula named, no LLM", and a concrete "$0.50 per call" cost signal. It does not say what happens when both prices and symbol are supplied, nor how fetch failures behave.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Dense but front-loaded: the capability list comes first, then input modes, then operational facts (deterministic, cost). The long enumeration is justified by a genuinely broad metric surface. Slight bloat from listing every formula that the metrics enum already encodes.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need no explanation. However, for a 13-parameter tool with nested objects and zero schema descriptions, the description omits how metrics selection interacts with the other arguments, whether prices/benchmark_prices are mutually exclusive with their symbol counterparts, and what the optional tuning params do.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% across 13 parameters including nested option, kelly, and windows objects, so the description must carry the load. It names prices/symbol, metrics, benchmark, option, and kelly, but leaves risk_free_rate, periods_per_year, windows, alpha, range, and language entirely undefined. Partial compensation with clear gaps.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific domain ("Trading and portfolio math") and then enumerates the exact computations: returns/CAGR, volatility, Sharpe, Sortino, max drawdown, VaR/CVaR, beta, alpha, correlation, SMA/EMA, RSI, Bollinger, Black-Scholes with Greeks, and Kelly. An agent can immediately tell this is a deterministic calculator rather than a forecasting or data-fetch sibling like hubvibe_market_forecast.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It clearly states the two input modes — "over prices you send or a ticker fetched live" — which tells an agent exactly when this tool is applicable and how to feed it. It does not name a sibling alternative or state when not to use it, so it stops short of full routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.