Skip to main content
Glama
Finance Toolkit

Finance Toolkit

momentum

Read-onlyIdempotent

Calculate technical indicators like RSI, MACD, and stochastic oscillators directly from price data, then summarize signals and factor performance across tickers.

Instructions

Momentum technical indicators (RSI, MACD, Stochastic Oscillator, Williams %R, Aroon, ADX, CCI, MFI, rate of change, Ichimoku Cloud, awesome, ultimate and Chande momentum oscillators, vortex, Know Sure Thing and more). Applied to price data automatically — no need to fetch prices first. Each indicator needs its window of history before it produces values, so the first periods after start_date can be empty and quarterly or yearly periods with long windows can be empty on short histories; start earlier to warm up. Requires tickers='AAPL' — use comma-separated values for multiple tickers. get_relative_strength gives the price relative to the benchmark, the Mansfield relative strength and a 1-99 relative strength rating across the tickers; get_seasonality the average return, hit rate and t-statistic per calendar month (frequency='month') or weekday (frequency='weekday'); get_signals the events per period: moving average crossovers (golden and death cross with the default 50 and 200), MACD crossovers, the RSI entering and leaving its overbought and oversold zones, Bollinger Band breakouts and new 52-week highs and lows, each 1 for a cross upwards, -1 for a cross downwards and 0 otherwise; signals_only=true returns only the periods with a signal (with limit=-5 the last five). get_indicator_summary summarises an indicator's history in one row per ticker instead of the daily series (use it rather than the full series for questions such as 'how low is the RSI compared with the last five years'): metric= the indicator (get_relative_strength_index by default, or any technical indicator, column= for one with several outputs), the latest value with its percentile and rank in its own history up to that date, the mean, minimum and maximum with their dates; below=30 (or above=70) adds the periods beyond the line, the number and last date of the crossings into that zone, and forward_periods=[5, 21, 63] the average return after those crossings next to the average return over every period; show_crossings=true lists every crossing with its value, percentile at the time and forward returns. Other parameters (e.g. window=) pass to the indicator. get_factor_analysis: factor analysis (predictive power) of the technical indicators across tickers: do the tickers that score high on one go on to return more than those that score low? Needs tickers= with at least ten, preferably twenty or more tickers. metrics= an indicator name, a comma-separated list, or a collection: 'momentum' (default), 'overlap', 'volatility', 'breadth' or 'all'; column= picks the output of a multi-output indicator (e.g. 'Signal Line'). Returns a row per metric and horizon: the mean information coefficient (IC, the Spearman rank correlation between the metric and the later returns), its standard deviation, IC information ratio, t-statistic, p-value, share of positive periods, number of periods, the Top Minus Bottom quantile spread, quantile turnover and rank autocorrelation. detail='information_coefficient', 'quantile_returns', 'quantile_turnover' or 'rank_autocorrelation' returns that part per period (or per quantile) for a single metric. period= sets how often it is evaluated (monthly by default), horizons= the periods ahead (e.g. 12 or [1, 12]), quantiles= the number of quantiles (5). Other parameters (e.g. window=) pass to the indicators; indicators in price units are used relative to the close. The IC is reported as measured: a negative IC means low values go on to outperform.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "indicator": "<indicator>"
    },
    "name": "momentum"
  }
}

Input Schema

NameRequiredDescriptionDefault
lagNoNumber of periods to lag when computing growth rates.
rankNotrue ranks the tickers (or countries) within every period, from the highest value (rank 1) to the lowest, and compares each with its neighbour toward the middle of the ranking: the Difference (in points for returns) and the Multiple (only when both have the same sign), so the first and last rank show how far the best and the worst stand apart, e.g. a fall more than twice as large as the next one. Needs a value per period and ticker; pick one field with show_columns where there are more.
aboveNoget_indicator_summary only: the line the indicator rises above, e.g. 70 for an overbought RSI.
belowNoget_indicator_summary only: the line the indicator falls below, e.g. 30 for an oversold RSI; adds the periods below it, the crossings into that zone and the returns after them.
limitNoThe rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead, and rows per ticker (an earnings calendar) are selected per ticker. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row.
columnNoThe price column to use, e.g. 'Close' or 'Adj Close'; for get_factor_analysis the output of a metric with several, e.g. 'Signal Line'.
detailNoget_factor_analysis only: 'information_coefficient', 'quantile_returns', 'quantile_turnover' or 'rank_autocorrelation' returns that part for a single metric instead of the summary.
growthNoReturn period-over-period growth rates instead of absolute values.
metricNoget_indicator_summary only: the indicator to summarise, e.g. 'get_relative_strength_index' (default) or 'get_stochastic_oscillator'.get_relative_strength_index
periodNoObservation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method). Leave unset to use the default of the indicator you selected. Defaults differ between indicators.
windowNoThe number of periods the indicator looks back over, e.g. 14 or 20. Leave unset to use the default of the indicator you selected. Defaults differ between indicators.
metricsNoget_factor_analysis only: the metric(s) to analyse, a method name such as 'get_price_to_earnings_ratio', a comma-separated list, or a collection of the tool (see the tool description), e.g. 'profitability'.momentum
tickersNoComma-separated ticker symbols, e.g. 'AAPL,MSFT,GOOGL'.
weightsNoThe four weights applied to each smoothed Rate of Change series before summing.
constantNoConstant multiplier used in the CCI calculation.
end_dateNoEnd of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window).
horizonsNoThe number of periods the forward returns cover.
window_1NoThe number of periods for the first short-term window.
window_2NoThe number of periods for the second mid-term window.
window_3NoThe number of periods for the third long-term window.
frequencyNo"month" (per calendar month) or "weekday" (per day of the week).month
indicatorYesName of the specific metric to calculate, one of the listed values. Required — search_metrics finds the indicator (and its tool) for a metric by name.
quantilesNoThe number of quantiles the tickers are sorted into per period.
quarterlyNoReturn quarterly data instead of annual when True.
rsi_windowNoThe window of the RSI.
start_dateNoStart of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window).
base_windowNoThe number of periods to consider for the Base Line (Kijun-sen) calculation, also used as the forward displacement for both Leading Spans.
long_windowNoThe window of the long moving average. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 200 for get_signals; 34 for get_awesome_oscillator.
roc_windowsNoThe four lookback periods used for the underlying Rate of Change calculations.
sma_windowsNoThe four Simple Moving Average smoothing periods applied to each Rate of Change series.
standardizeNoReturn the Z-Score (standard score) instead of the raw values, i.e. how many standard deviations each value is from the mean of its own series. When combined with growth=True, the growth values are standardized instead of the raw values.
close_columnNoThe column in the historical data that represents.Adj Close
rsi_oversoldNoThe RSI below which a price is oversold.
short_windowNoThe window of the short moving average. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 5 for get_awesome_oscillator; 50 for get_signals.
show_columnsNoComma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage.
signals_onlyNoget_signals and get_candlestick_patterns only: set to true to return only the periods with a signal or pattern, e.g. with limit=-5 for the last five.
periods_apartNoThe number of periods between the dates the quantile turnover and the rank autocorrelation compare.
signal_windowNoFor get_moving_average_convergence_divergence: The number of periods for the signal line. For get_know_sure_thing: Number of periods for the Simple Moving Average of the KST used as the signal line.
smooth_windowNoThe number of periods used to smooth the %K line into the %D signal line.
rsi_overboughtNoThe RSI above which a price is overbought.
show_crossingsNoget_indicator_summary only: set to true for a row per crossing (date, value, its percentile at the time and the forward returns) instead of the summary.
forward_periodsNoget_indicator_summary only: the trading periods after each crossing to measure the return over, e.g. [5, 21, 63] for about a week, a month and a quarter.
high_low_windowNoThe number of previous periods a new high or low is measured against.
benchmark_tickerNoTicker used as the market benchmark, e.g. 'SPY' or '^GSPC'; 'None' for no benchmark.SPY
bollinger_windowNoThe window of the Bollinger Bands.
macd_long_windowNoThe long window of the MACD.
bollinger_std_devNoThe number of standard deviations of the Bollinger Bands.
conversion_windowNoThe number of periods to consider for the Conversion Line (Tenkan-sen) calculation.
macd_short_windowNoThe short window of the MACD.
lead_span_b_windowNoThe number of periods to consider for the Lead Span B (Senkou Span B) calculation.
macd_signal_windowNoThe window of the MACD's signal line.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv2.3.4
    • addedInput schema / properties / rank
      Added value: +{
      +  "default": false,
      +  "description": "true ranks the tickers (or countries) within every period, from the highest value (rank 1) to the lowest, and compares each with its neighbour toward the middle of the ranking: the Difference (in points for returns) and the Multiple (only when both have the same sign), so the first and last rank show how far the best and the worst stand apart, e.g. a fall more than twice as large as the next one. Needs a value per period and ticker; pick one field with show_columns where there are more.",
      +  "type": "boolean"
      +}
  2. Changed29 schema fields changedv2.3.2
    • addedInput schema / properties / above
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "get_indicator_summary only: the line the indicator rises above, e.g. 70 for an overbought RSI."
      +}
    • addedInput schema / properties / below
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "get_indicator_summary only: the line the indicator falls below, e.g. 30 for an oversold RSI; adds the periods below it, the crossings into that zone and the returns after them."
      +}
    • addedInput schema / properties / bollinger_std_dev
      Added value: +{
      +  "default": 2,
      +  "description": "The number of standard deviations of the Bollinger Bands.",
      +  "type": "number"
      +}
    • addedInput schema / properties / bollinger_window
      Added value: +{
      +  "default": 20,
      +  "description": "The window of the Bollinger Bands.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / column
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The price column to use, e.g. 'Close' or 'Adj Close'; for get_factor_analysis the output of a metric with several, e.g. 'Signal Line'."
      +}
    • addedInput schema / properties / detail
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "get_factor_analysis only: 'information_coefficient', 'quantile_returns', 'quantile_turnover' or 'rank_autocorrelation' returns that part for a single metric instead of the summary."
      +}
    • addedInput schema / properties / forward_periods
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "items": {
      +        "type": "integer"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "get_indicator_summary only: the trading periods after each crossing to measure the return over, e.g. [5, 21, 63] for about a week, a month and a quarter."
      +}
    • addedInput schema / properties / high_low_window
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The number of previous periods a new high or low is measured against."
      +}
    • addedInput schema / properties / horizons
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "items": {
      +        "type": "integer"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The number of periods the forward returns cover."
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_money_flow_index",
      -  "get_williams_percent_r",
      -  "get_aroon_indicator",
      -  "get_commodity_channel_index",
      -  "get_relative_vigor_index",
      -  "get_force_index",
      -  "get_ultimate_oscillator",
      -  "get_percentage_price_oscillator",
      -  "get_detrended_price_oscillator",
      -  "get_average_directional_index",
      -  "get_chande_momentum_oscillator",
      -  "get_ichimoku_cloud",
      -  "get_stochastic_oscillator",
      -  "get_moving_average_convergence_divergence",
      -  "get_relative_strength_index",
      -  "get_balance_of_power",
      -  "get_awesome_oscillator",
      -  "get_vortex_indicator",
      -  "get_elder_ray_index",
      -  "get_rate_of_change",
      -  "get_choppiness_index",
      -  "get_know_sure_thing",
      -  "get_relative_strength",
      -  "get_seasonality"
      -]New value: +[
      +  "get_money_flow_index",
      +  "get_williams_percent_r",
      +  "get_aroon_indicator",
      +  "get_commodity_channel_index",
      +  "get_relative_vigor_index",
      +  "get_force_index",
      +  "get_ultimate_oscillator",
      +  "get_percentage_price_oscillator",
      +  "get_detrended_price_oscillator",
      +  "get_average_directional_index",
      +  "get_chande_momentum_oscillator",
      +  "get_ichimoku_cloud",
      +  "get_stochastic_oscillator",
      +  "get_moving_average_convergence_divergence",
      +  "get_relative_strength_index",
      +  "get_balance_of_power",
      +  "get_awesome_oscillator",
      +  "get_vortex_indicator",
      +  "get_elder_ray_index",
      +  "get_rate_of_change",
      +  "get_choppiness_index",
      +  "get_know_sure_thing",
      +  "get_relative_strength",
      +  "get_seasonality",
      +  "get_factor_analysis",
      +  "get_signals",
      +  "get_indicator_summary"
      +]
    • changedInput schema / properties / limit / description
      Previous value: -"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row."New value: +"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead, and rows per ticker (an earnings calendar) are selected per ticker. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row."
    • changedInput schema / properties / long_window / description
      Previous value: -"For get_percentage_price_oscillator: The number of periods for the long-term moving average. For get_moving_average_convergence_divergence: The number of periods for the longer moving average. For get_awesome_oscillator: The number of periods for the long-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 34 for get_awesome_oscillator."New value: +"The window of the long moving average. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 200 for get_signals; 34 for get_awesome_oscillator."
    • addedInput schema / properties / macd_long_window
      Added value: +{
      +  "default": 26,
      +  "description": "The long window of the MACD.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / macd_short_window
      Added value: +{
      +  "default": 12,
      +  "description": "The short window of the MACD.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / macd_signal_window
      Added value: +{
      +  "default": 9,
      +  "description": "The window of the MACD's signal line.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / metric
      Added value: +{
      +  "default": "get_relative_strength_index",
      +  "description": "get_indicator_summary only: the indicator to summarise, e.g. 'get_relative_strength_index' (default) or 'get_stochastic_oscillator'.",
      +  "type": "string"
      +}
    • addedInput schema / properties / metrics
      Added value: +{
      +  "default": "momentum",
      +  "description": "get_factor_analysis only: the metric(s) to analyse, a method name such as 'get_price_to_earnings_ratio', a comma-separated list, or a collection of the tool (see the tool description), e.g. 'profitability'.",
      +  "type": "string"
      +}
    • addedInput schema / properties / period / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / period / default
      Previous value: -"daily"New value: +null
    • changedInput schema / properties / period / description
      Previous value: -"Observation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method)."New value: +"Observation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method). Leave unset to use the default of the indicator you selected. Defaults differ between indicators."
    • removedInput schema / properties / period / type
      Removed value: -"string"
    • addedInput schema / properties / periods_apart
      Added value: +{
      +  "default": 1,
      +  "description": "The number of periods between the dates the quantile turnover and the rank autocorrelation compare.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / quantiles
      Added value: +{
      +  "default": 5,
      +  "description": "The number of quantiles the tickers are sorted into per period.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / rsi_overbought
      Added value: +{
      +  "default": 70,
      +  "description": "The RSI above which a price is overbought.",
      +  "type": "number"
      +}
    • addedInput schema / properties / rsi_oversold
      Added value: +{
      +  "default": 30,
      +  "description": "The RSI below which a price is oversold.",
      +  "type": "number"
      +}
    • addedInput schema / properties / rsi_window
      Added value: +{
      +  "default": 14,
      +  "description": "The window of the RSI.",
      +  "type": "integer"
      +}
    • changedInput schema / properties / short_window / description
      Previous value: -"For get_percentage_price_oscillator: The number of periods for the short-term moving average. For get_moving_average_convergence_divergence: The number of periods for the shorter moving average. For get_awesome_oscillator: The number of periods for the short-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 5 for get_awesome_oscillator."New value: +"The window of the short moving average. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 5 for get_awesome_oscillator; 50 for get_signals."
    • addedInput schema / properties / show_crossings
      Added value: +{
      +  "default": false,
      +  "description": "get_indicator_summary only: set to true for a row per crossing (date, value, its percentile at the time and the forward returns) instead of the summary.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / signals_only
      Added value: +{
      +  "default": false,
      +  "description": "get_signals and get_candlestick_patterns only: set to true to return only the periods with a signal or pattern, e.g. with limit=-5 for the last five.",
      +  "type": "boolean"
      +}
  3. Changed6 schema fields changedv2.3.1
    • changedInput schema / properties / benchmark_ticker / description
      Previous value: -"Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'."New value: +"Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'; 'None' for no benchmark."
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-27"New value: +""
    • changedInput schema / properties / end_date / description
      Previous value: -"End of the date range in YYYY-MM-DD format."New value: +"End of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window)."
    • changedInput schema / properties / limit / description
      Previous value: -"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length."New value: +"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row."
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-28"New value: +""
    • changedInput schema / properties / start_date / description
      Previous value: -"Start of the date range in YYYY-MM-DD format."New value: +"Start of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window)."
  4. Changed8 schema fields changedv2.3.0
    • changedInput schema / properties / close_column / description
      Previous value: -"For get_money_flow_index, get_williams_percent_r: The name of the column containing the close prices. For get_aroon_indicator, get_ichimoku_cloud, get_stochastic_oscillator, get_moving_average_convergence_divergence, get_relative_strength_index, get_balance_of_power, get_awesome_oscillator, get_vortex_indicator, get_elder_ray_index, get_rate_of_change, get_choppiness_index, get_know_sure_thing: The column name for closing prices in the historical data. For get_commodity_channel_index, get_relative_vigor_index, get_force_index, get_ultimate_oscillator, get_percentage_price_oscillator, get_detrended_price_oscillator, get_average_directional_index, get_chande_momentum_oscillator: The column in the historical data that represents the closing prices."New value: +"The column in the historical data that represents."
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-14"New value: +"2026-10-27"
    • addedInput schema / properties / frequency
      Added value: +{
      +  "default": "month",
      +  "description": "\"month\" (per calendar month) or \"weekday\" (per day of the week).",
      +  "type": "string"
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_money_flow_index",
      -  "get_williams_percent_r",
      -  "get_aroon_indicator",
      -  "get_commodity_channel_index",
      -  "get_relative_vigor_index",
      -  "get_force_index",
      -  "get_ultimate_oscillator",
      -  "get_percentage_price_oscillator",
      -  "get_detrended_price_oscillator",
      -  "get_average_directional_index",
      -  "get_chande_momentum_oscillator",
      -  "get_ichimoku_cloud",
      -  "get_stochastic_oscillator",
      -  "get_moving_average_convergence_divergence",
      -  "get_relative_strength_index",
      -  "get_balance_of_power",
      -  "get_awesome_oscillator",
      -  "get_vortex_indicator",
      -  "get_elder_ray_index",
      -  "get_rate_of_change",
      -  "get_choppiness_index",
      -  "get_know_sure_thing"
      -]New value: +[
      +  "get_money_flow_index",
      +  "get_williams_percent_r",
      +  "get_aroon_indicator",
      +  "get_commodity_channel_index",
      +  "get_relative_vigor_index",
      +  "get_force_index",
      +  "get_ultimate_oscillator",
      +  "get_percentage_price_oscillator",
      +  "get_detrended_price_oscillator",
      +  "get_average_directional_index",
      +  "get_chande_momentum_oscillator",
      +  "get_ichimoku_cloud",
      +  "get_stochastic_oscillator",
      +  "get_moving_average_convergence_divergence",
      +  "get_relative_strength_index",
      +  "get_balance_of_power",
      +  "get_awesome_oscillator",
      +  "get_vortex_indicator",
      +  "get_elder_ray_index",
      +  "get_rate_of_change",
      +  "get_choppiness_index",
      +  "get_know_sure_thing",
      +  "get_relative_strength",
      +  "get_seasonality"
      +]
    • changedInput schema / properties / long_window / description
      Previous value: -"For get_percentage_price_oscillator: The number of periods for the long-term moving average. For get_moving_average_convergence_divergence: The number of periods for the longer moving average. For get_awesome_oscillator: The number of periods for the long-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence; 28 for get_percentage_price_oscillator; 34 for get_awesome_oscillator."New value: +"For get_percentage_price_oscillator: The number of periods for the long-term moving average. For get_moving_average_convergence_divergence: The number of periods for the longer moving average. For get_awesome_oscillator: The number of periods for the long-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 34 for get_awesome_oscillator."
    • changedInput schema / properties / short_window / description
      Previous value: -"For get_percentage_price_oscillator: The number of periods for the short-term moving average. For get_moving_average_convergence_divergence: The number of periods for the shorter moving average. For get_awesome_oscillator: The number of periods for the short-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence; 5 for get_awesome_oscillator; 7 for get_percentage_price_oscillator."New value: +"For get_percentage_price_oscillator: The number of periods for the short-term moving average. For get_moving_average_convergence_divergence: The number of periods for the shorter moving average. For get_awesome_oscillator: The number of periods for the short-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 5 for get_awesome_oscillator."
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-15"New value: +"2021-10-28"
    • changedInput schema / properties / weights / description
      Previous value: -"The portfolio weight per ticker as an object, e.g. {'AAPL': 0.6, 'MSFT': 0.4}; equal weights when left unset."New value: +"The four weights applied to each smoothed Rate of Change series before summing."
  5. Changed53 schema fields changedv2.2.3
    • changedInput schema / properties / base_window / description
      Previous value: -"Value for base_window."New value: +"The number of periods to consider for the Base Line (Kijun-sen) calculation, also used as the forward displacement for both Leading Spans."
    • removedInput schema / properties / base_window / title
      Removed value: -"Base Window"
    • removedInput schema / properties / benchmark_ticker / title
      Removed value: -"Benchmark Ticker"
    • changedInput schema / properties / close_column / description
      Previous value: -"Value for close_column."New value: +"For get_money_flow_index, get_williams_percent_r: The name of the column containing the close prices. For get_aroon_indicator, get_ichimoku_cloud, get_stochastic_oscillator, get_moving_average_convergence_divergence, get_relative_strength_index, get_balance_of_power, get_awesome_oscillator, get_vortex_indicator, get_elder_ray_index, get_rate_of_change, get_choppiness_index, get_know_sure_thing: The column name for closing prices in the historical data. For get_commodity_channel_index, get_relative_vigor_index, get_force_index, get_ultimate_oscillator, get_percentage_price_oscillator, get_detrended_price_oscillator, get_average_directional_index, get_chande_momentum_oscillator: The column in the historical data that represents the closing prices."
    • removedInput schema / properties / close_column / title
      Removed value: -"Close Column"
    • changedInput schema / properties / constant / description
      Previous value: -"Value for constant."New value: +"Constant multiplier used in the CCI calculation."
    • removedInput schema / properties / constant / title
      Removed value: -"Constant"
    • changedInput schema / properties / conversion_window / description
      Previous value: -"Value for conversion_window."New value: +"The number of periods to consider for the Conversion Line (Tenkan-sen) calculation."
    • removedInput schema / properties / conversion_window / title
      Removed value: -"Conversion Window"
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-02"New value: +"2026-10-14"
    • removedInput schema / properties / end_date / title
      Removed value: -"End Date"
    • removedInput schema / properties / growth / title
      Removed value: -"Growth"
    • changedInput schema / properties / indicator / description
      Previous value: -"Name of the specific metric to calculate, e.g. 'get_asset_turnover_ratio'. Required — omitting it returns the list of available indicators."New value: +"Name of the specific metric to calculate, one of the listed values. Required — search_metrics finds the indicator (and its tool) for a metric by name."
    • removedInput schema / properties / indicator / title
      Removed value: -"Indicator"
    • addedInput schema / properties / lag / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "items": {
      +      "type": "integer"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / lag / title
      Removed value: -"Lag"
    • removedInput schema / properties / lag / type
      Removed value: -"integer"
    • changedInput schema / properties / lead_span_b_window / description
      Previous value: -"Value for lead_span_b_window."New value: +"The number of periods to consider for the Lead Span B (Senkou Span B) calculation."
    • removedInput schema / properties / lead_span_b_window / title
      Removed value: -"Lead Span B Window"
    • addedInput schema / properties / limit
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length."
      +}
    • changedInput schema / properties / long_window / description
      Previous value: -"Value for long_window. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence; 28 for get_percentage_price_oscillator; 34 for get_awesome_oscillator."New value: +"For get_percentage_price_oscillator: The number of periods for the long-term moving average. For get_moving_average_convergence_divergence: The number of periods for the longer moving average. For get_awesome_oscillator: The number of periods for the long-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence; 28 for get_percentage_price_oscillator; 34 for get_awesome_oscillator."
    • removedInput schema / properties / long_window / title
      Removed value: -"Long Window"
    • changedInput schema / properties / period / description
      Previous value: -"Observation frequency, e.g. 'monthly', 'quarterly', or 'annual'."New value: +"Observation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method)."
    • removedInput schema / properties / period / title
      Removed value: -"Period"
    • removedInput schema / properties / quarterly / title
      Removed value: -"Quarterly"
    • changedInput schema / properties / roc_windows / description
      Previous value: -"Value for roc_windows."New value: +"The four lookback periods used for the underlying Rate of Change calculations."
    • removedInput schema / properties / roc_windows / title
      Removed value: -"Roc Windows"
    • changedInput schema / properties / short_window / description
      Previous value: -"Value for short_window. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence; 5 for get_awesome_oscillator; 7 for get_percentage_price_oscillator."New value: +"For get_percentage_price_oscillator: The number of periods for the short-term moving average. For get_moving_average_convergence_divergence: The number of periods for the shorter moving average. For get_awesome_oscillator: The number of periods for the short-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence; 5 for get_awesome_oscillator; 7 for get_percentage_price_oscillator."
    • removedInput schema / properties / short_window / title
      Removed value: -"Short Window"
    • removedInput schema / properties / show_columns / title
      Removed value: -"Show Columns"
    • changedInput schema / properties / signal_window / description
      Previous value: -"Value for signal_window."New value: +"For get_moving_average_convergence_divergence: The number of periods for the signal line. For get_know_sure_thing: Number of periods for the Simple Moving Average of the KST used as the signal line."
    • removedInput schema / properties / signal_window / title
      Removed value: -"Signal Window"
    • changedInput schema / properties / sma_windows / description
      Previous value: -"Value for sma_windows."New value: +"The four Simple Moving Average smoothing periods applied to each Rate of Change series."
    • removedInput schema / properties / sma_windows / title
      Removed value: -"Sma Windows"
    • changedInput schema / properties / smooth_window / description
      Previous value: -"Value for smooth_window."New value: +"The number of periods used to smooth the %K line into the %D signal line."
    • removedInput schema / properties / smooth_window / title
      Removed value: -"Smooth Window"
    • removedInput schema / properties / standardize / title
      Removed value: -"Standardize"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-03"New value: +"2021-10-15"
    • removedInput schema / properties / start_date / title
      Removed value: -"Start Date"
    • addedInput schema / properties / tickers / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / tickers / title
      Removed value: -"Tickers"
    • removedInput schema / properties / tickers / type
      Removed value: -"string"
    • changedInput schema / properties / weights / description
      Previous value: -"Value for weights."New value: +"The portfolio weight per ticker as an object, e.g. {'AAPL': 0.6, 'MSFT': 0.4}; equal weights when left unset."
    • removedInput schema / properties / weights / title
      Removed value: -"Weights"
    • changedInput schema / properties / window / description
      Previous value: -"Value for window. Leave unset to use the default of the indicator you selected. Defaults differ between indicators."New value: +"The number of periods the indicator looks back over, e.g. 14 or 20. Leave unset to use the default of the indicator you selected. Defaults differ between indicators."
    • removedInput schema / properties / window / title
      Removed value: -"Window"
    • changedInput schema / properties / window_1 / description
      Previous value: -"Value for window_1."New value: +"The number of periods for the first short-term window."
    • removedInput schema / properties / window_1 / title
      Removed value: -"Window 1"
    • changedInput schema / properties / window_2 / description
      Previous value: -"Value for window_2."New value: +"The number of periods for the second mid-term window."
    • removedInput schema / properties / window_2 / title
      Removed value: -"Window 2"
    • changedInput schema / properties / window_3 / description
      Previous value: -"Value for window_3."New value: +"The number of periods for the third long-term window."
    • removedInput schema / properties / window_3 / title
      Removed value: -"Window 3"
    • removedInput schema / title
      Removed value: -"momentumArguments"
  6. Changed2 schema fields changedv2.2.1
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-08-19"New value: +"2026-10-02"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-08-20"New value: +"2021-10-03"
  7. Changed22 schema fields changedv2.2.0
    • changedInput schema / properties / base_window / default
      Previous value: -20New value: +26
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-14"New value: +"2026-08-19"
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_money_flow_index",
      -  "get_williams_percent_r",
      -  "get_aroon_indicator",
      -  "get_commodity_channel_index",
      -  "get_relative_vigor_index",
      -  "get_force_index",
      -  "get_ultimate_oscillator",
      -  "get_percentage_price_oscillator",
      -  "get_detrended_price_oscillator",
      -  "get_average_directional_index",
      -  "get_chande_momentum_oscillator",
      -  "get_ichimoku_cloud",
      -  "get_stochastic_oscillator",
      -  "get_moving_average_convergence_divergence",
      -  "get_relative_strength_index",
      -  "get_balance_of_power"
      -]New value: +[
      +  "get_money_flow_index",
      +  "get_williams_percent_r",
      +  "get_aroon_indicator",
      +  "get_commodity_channel_index",
      +  "get_relative_vigor_index",
      +  "get_force_index",
      +  "get_ultimate_oscillator",
      +  "get_percentage_price_oscillator",
      +  "get_detrended_price_oscillator",
      +  "get_average_directional_index",
      +  "get_chande_momentum_oscillator",
      +  "get_ichimoku_cloud",
      +  "get_stochastic_oscillator",
      +  "get_moving_average_convergence_divergence",
      +  "get_relative_strength_index",
      +  "get_balance_of_power",
      +  "get_awesome_oscillator",
      +  "get_vortex_indicator",
      +  "get_elder_ray_index",
      +  "get_rate_of_change",
      +  "get_choppiness_index",
      +  "get_know_sure_thing"
      +]
    • changedInput schema / properties / lead_span_b_window / default
      Previous value: -40New value: +52
    • addedInput schema / properties / long_window / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / long_window / default
      Previous value: -28New value: +null
    • changedInput schema / properties / long_window / description
      Previous value: -"Value for long_window."New value: +"Value for long_window. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence; 28 for get_percentage_price_oscillator; 34 for get_awesome_oscillator."
    • removedInput schema / properties / long_window / type
      Removed value: -"integer"
    • addedInput schema / properties / roc_windows
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for roc_windows.",
      +  "title": "Roc Windows"
      +}
    • addedInput schema / properties / short_window / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / short_window / default
      Previous value: -7New value: +null
    • changedInput schema / properties / short_window / description
      Previous value: -"Value for short_window."New value: +"Value for short_window. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence; 5 for get_awesome_oscillator; 7 for get_percentage_price_oscillator."
    • removedInput schema / properties / short_window / type
      Removed value: -"integer"
    • addedInput schema / properties / sma_windows
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for sma_windows.",
      +  "title": "Sma Windows"
      +}
    • removedInput schema / properties / smooth_widow
      Removed value: -{
      -  "default": 3,
      -  "description": "Value for smooth_widow.",
      -  "title": "Smooth Widow",
      -  "type": "integer"
      -}
    • addedInput schema / properties / smooth_window
      Added value: +{
      +  "default": 3,
      +  "description": "Value for smooth_window.",
      +  "title": "Smooth Window",
      +  "type": "integer"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-15"New value: +"2021-08-20"
    • addedInput schema / properties / weights
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for weights.",
      +  "title": "Weights"
      +}
    • addedInput schema / properties / window / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / window / default
      Previous value: -14New value: +null
    • changedInput schema / properties / window / description
      Previous value: -"Value for window."New value: +"Value for window. Leave unset to use the default of the indicator you selected. Defaults differ between indicators."
    • removedInput schema / properties / window / type
      Removed value: -"integer"
  8. Changed3 schema fields changed
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-09"New value: +"2026-07-14"
    • addedInput schema / properties / standardize
      Added value: +{
      +  "default": false,
      +  "description": "Return the Z-Score (standard score) instead of the raw values, i.e. how many standard deviations each value is from the mean of its own series. When combined with growth=True, the growth values are standardized instead of the raw values.",
      +  "title": "Standardize",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-10"New value: +"2021-07-15"
  9. Changed2 schema fields changedv2.1.4
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-27"New value: +"2026-07-09"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-28"New value: +"2021-07-10"
  10. Changed2 schema fields changedv2.1.3
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-23"New value: +"2026-06-27"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-24"New value: +"2021-06-28"
  11. Changed4 schema fields changedv0.1.2
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-22"New value: +"2026-06-23"
    • removedInput schema / properties / rounding
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "integer"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "Number of decimal places to round results to.",
      -  "title": "Rounding"
      -}
    • addedInput schema / properties / show_columns
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Comma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage.",
      +  "title": "Show Columns"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-23"New value: +"2021-06-24"
  12. Addedv0.1.1

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint and openWorldHint, so safety is covered; the description adds genuinely new behavior: prices are fetched automatically, long windows produce empty leading periods on short histories, the IC is reported as measured with a negative IC meaning low values outperform. It does not discuss rate limits or error behavior, but for a read-only analytical tool the added context is substantial.

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

Conciseness3/5

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

The opening sentence is well front-loaded and the warm-up and tickers requirements follow early, but the remainder is a dense run of semicolon-chained clauses covering six distinct modes, which is hard to scan. Some length is justified by 27 enum modes and 51 parameters, yet a bulleted breakdown per mode would have delivered the same content more efficiently.

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

Completeness5/5

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

Given an output schema, full annotations and 100% schema coverage, the description fills the remaining gaps: automatic price retrieval, history warm-up, ticker cardinality requirements for factor analysis, and interpretation of the reported IC sign. An agent has enough information to choose a mode and invoke it correctly without guessing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, and the description goes beyond the schema by explaining interactions: window= and other parameters 'pass to the indicator', column= selects an output of a multi-output indicator, below=/above= add zone statistics plus forward_periods returns, detail= returns one factor-analysis component per period. These are semantic relationships the per-parameter descriptions do not fully spell out on their own.

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

Purpose4/5

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

The description opens with a concrete resource ('Momentum technical indicators') and enumerates the covered indicators (RSI, MACD, Stochastic, Williams %R, Aroon, ADX, CCI, MFI, ROC, Ichimoku, etc.), then names the four special modes (get_relative_strength, get_seasonality, get_signals, get_indicator_summary) and get_factor_analysis. An agent can tell exactly what the tool computes. It stops short of distinguishing this tool from sibling category tools such as 'overlap' or 'volatility', even though the enum contains overlap-style indicators (Ichimoku, Aroon, ADX).

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?

Strong in-tool routing: it says to use get_indicator_summary 'rather than the full series for questions such as how low is the RSI compared with the last five years', and states prerequisites for each mode (tickers='AAPL' required, get_factor_analysis needs at least ten, preferably twenty or more tickers). It also explains the warm-up caveat and tells the agent to start earlier. What is missing is cross-tool guidance — nothing says when to pick this tool over the sibling 'overlap' or 'volatility' tools.

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