Skip to main content
Glama
Finance Toolkit

Finance Toolkit

market_data

Read-onlyIdempotent

Retrieve raw financial data for tickers—historical prices, statements, quotes, calendars, analyst estimates and ownership—when you need source values rather than precomputed ratios.

Instructions

Raw financial data (historical prices, income statement, balance sheet, cash flow statement, company profile, quotes, analyst estimates (get_analyst_estimates: consensus revenue, EBITDA, EBIT, net income, SGA and EPS per period with the number of analysts behind the revenue and the EPS consensus, 'Number of Analysts Revenue' and 'Number of Analysts EPS'; far-out years often rest on a few), dividend/earnings calendars (with the scheduled dates after today, e.g. the next earnings release), statistics, market risk premium by country, CFTC Commitment of Traders report, executives and their compensation, company notes, employee count, share float, mergers and acquisitions, stock splits, insider trade statistics, institutional (13F) ownership per quarter, FINRA daily short sale volume, analyst stock grades, analyst price targets (get_price_targets: today's consensus, high, low and median with the upside to the share price, the dispersion, the revision momentum and the date of the most recent target with the days since; get_price_target_history: every published target with the upside it implied and the analyst company's previous target (published in the year before), its date and the Target Change; a target without a previous one is new coverage), monthly buy/hold/sell recommendation counts with the mean recommendation (get_analyst_recommendations), earnings call transcripts). Use this ONLY for raw data needs — for pre-computed ratios, performance, risk, or model metrics use the dedicated tools instead. Requires tickers='AAPL' — use comma-separated values for multiple tickers. basket=true adds a 'Total' to the financial statements, each line item the sum of the tickers (e.g. the combined capital expenditure of a group of companies with trailing=4 and quarterly=true; EPS and share counts stay empty). get_market_risk_premium (by country) and get_treasury_data (US Treasury rates) are market-wide and need no tickers. get_commitment_of_traders takes CFTC futures symbols, e.g. tickers='NG' (natural gas) or 'GC' (gold), not stocks. get_earnings_surprise gives per announcement the EPS and revenue against the analyst consensus (surprise as a decimal), the SUE and the share's reaction over days -1 to +1 against the benchmark. get_earnings_call_transcripts returns the full, never shortened text (often 40,000 to 60,000 characters) of one call of one ticker: the most recent, or the one of fiscal_period (e.g. '2025Q4', the company's own fiscal quarter); call it once per ticker and period. A period without a transcript is answered with the most recent periods that have one. Currency and crypto pairs may be written either way: EURUSD or EURUSD=X, BTCUSD or BTC-USD. get_short_volume is the daily short SALE volume FINRA reports for US-listed stocks (short volume, total FINRA-reported volume, short volume ratio and its z-score), not short interest; it covers the history_days (92 by default, one download per trading day) before end_date. To find which instruments exist, use the Finance Database server. The holdings, information and sector and country weightings of ETFs and funds are in the etf tool.

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": "market_data"
  }
}

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.
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.
basketNoAlso analyse the tickers as one company, 'Total': its statements are the sums of theirs and its ratios are calculated on those sums (per-share figures stay empty).
growthNoReturn period-over-period growth rates instead of absolute values.
latestNoWhether to only retrieve the most recent transcript. When False, every transcript between the start_date and end_date is retrieved.
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 are 'daily' for get_historical_data, get_treasury_data; '1hour' for get_intraday_data.
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 are 1 for get_earnings_surprise; 20 for get_short_volume.
tickersNoComma-separated ticker symbols, e.g. 'AAPL,MSFT,GOOGL'.
compoundNoWith growth=true, return the compound annual growth rate (CAGR) over the lag instead of the total change, e.g. lag=5 for the five-year CAGR (lag=20 with quarterly=true). Missing when either value is zero or negative.
end_dateNoEnd of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window).
fill_nanNoFor get_historical_data, get_treasury_data: Defines whether to forward fill NaN values. This defaults to True to prevent holes in the dataset. This is especially relevant for technical indicators. For get_intraday_data: Defines whether to forward fill NaN values.
trailingNoTrailing window size in number of periods. Sums the raw values over the trailing N periods (e.g. trailing=4 on quarterly data gives a trailing-4-quarter / TTM-style sum) instead of returning one value per period.
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.
quarterlyNoReturn quarterly data instead of annual when True.
start_dateNoStart of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window).
sue_windowNoThe number of earlier announcements whose EPS surprises scale the SUE.
show_errorsNoWhether to report retrieval errors.
actual_datesNoDefines whether to return the actual dates or the corresponding quarters.
history_daysNoThe number of calendar days before the Toolkit's end date to retrieve, never before its start date. None retrieves the Toolkit's whole date range (one download per trading day). Leave unset to use the default of the indicator you selected. Defaults are 92 for get_short_volume.
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.
fiscal_periodNoThe company's fiscal quarter, e.g. '2025Q4' (its own fiscal year, which differs from the calendar year for e.g. Apple and Microsoft). Leave unset for the most recent.
return_columnNoThe column to use for the return calculation. Leave unset to use the default of the indicator you selected. Defaults are 'Adj Close' for get_historical_data; 'Close' for get_intraday_data.
divide_ohlc_byNoA value to divide the yields by. Treasury yields are published in percent, so this defaults to 100 to return decimals.
enforce_sourceNoFor get_balance_sheet_statement, get_cash_flow_statement, get_income_statement, get_statistics_statement: Forces this specific call to use a given source, either "FinancialModelingPrep" or "YahooFinance". This takes precedence over the source set on the Toolkit itself, so one instance can pull historical data from Yahoo Finance while still using a FinancialModelingPrep key for the financial... For get_historical_data: A string containing the historical source you wish to enforce. This can be either FinancialModelingPrep or YahooFinance. For get_treasury_data: Forces this specific call to use a given source, either "FinancialModelingPrep" or "YahooFinance". This takes precedence over the source set on the Toolkit itself.
risk_free_rateNoThe US Treasury yield used as the risk-free rate: '13w' (the 13-week bill), '5y', '10y' (default) or '30y'.
benchmark_tickerNoTicker used as the market benchmark, e.g. 'SPY' or '^GSPC'; 'None' for no benchmark.SPY
include_dividendsNoDefines whether to include dividends in the return calculation.
show_ticker_separationNoA boolean representing whether to show which tickers acquired data from FinancialModelingPrep and which tickers acquired data from YahooFinance.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changedv2.3.4
    • addedInput schema / properties / basket
      Added value: +{
      +  "default": false,
      +  "description": "Also analyse the tickers as one company, 'Total': its statements are the sums of theirs and its ratios are calculated on those sums (per-share figures stay empty).",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / enforce_source / description
      Previous value: -"For get_balance_sheet_statement, get_cash_flow_statement, get_income_statement, get_statistics_statement: Forces this specific call to use a given source, either \"FinancialModelingPrep\" or \"YahooFinance\". This takes precedence over the source set on the Toolkit itself, so one instance can pull historical data from the free Yahoo Finance source while still using a FinancialModelingPrep key for the... For get_historical_data: A string containing the historical source you wish to enforce. This can be either FinancialModelingPrep or YahooFinance. For get_treasury_data: Forces this specific call to use a given source, either \"FinancialModelingPrep\" or \"YahooFinance\". This takes precedence over the source set on the Toolkit itself."New value: +"For get_balance_sheet_statement, get_cash_flow_statement, get_income_statement, get_statistics_statement: Forces this specific call to use a given source, either \"FinancialModelingPrep\" or \"YahooFinance\". This takes precedence over the source set on the Toolkit itself, so one instance can pull historical data from Yahoo Finance while still using a FinancialModelingPrep key for the financial... For get_historical_data: A string containing the historical source you wish to enforce. This can be either FinancialModelingPrep or YahooFinance. For get_treasury_data: Forces this specific call to use a given source, either \"FinancialModelingPrep\" or \"YahooFinance\". This takes precedence over the source set on the Toolkit itself."
    • 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. Changed5 schema fields changedv2.3.3
    • changedInput schema / properties / history_days / default
      Previous value: -92New value: +null
    • changedInput schema / properties / history_days / description
      Previous value: -"The number of calendar days before the Toolkit's end date to retrieve, never before its start date. None retrieves the Toolkit's whole date range (one download per trading day)."New value: +"The number of calendar days before the Toolkit's end date to retrieve, never before its start date. None retrieves the Toolkit's whole date range (one download per trading day). Leave unset to use the default of the indicator you selected. Defaults are 92 for get_short_volume."
    • changedInput schema / properties / risk_free_rate / description
      Previous value: -"One maturity to return ('13w', '5y', '10y' or '30y'). The Toolkit's own risk free rate stays the maturity set on the Toolkit either way."New value: +"The US Treasury yield used as the risk-free rate: '13w' (the 13-week bill), '5y', '10y' (default) or '30y'."
    • addedInput schema / properties / show_ticker_separation
      Added value: +{
      +  "default": true,
      +  "description": "A boolean representing whether to show which tickers acquired data from FinancialModelingPrep and which tickers acquired data from YahooFinance.",
      +  "type": "boolean"
      +}
    • removedInput schema / properties / show_ticker_seperation
      Removed value: -{
      -  "default": true,
      -  "description": "A boolean representing whether to show which tickers acquired data from FinancialModelingPrep and which tickers acquired data from YahooFinance.",
      -  "type": "boolean"
      -}
  3. Changed6 schema fields changedv2.3.2
    • addedInput schema / properties / compound
      Added value: +{
      +  "default": false,
      +  "description": "With growth=true, return the compound annual growth rate (CAGR) over the lag instead of the total change, e.g. lag=5 for the five-year CAGR (lag=20 with quarterly=true). Missing when either value is zero or negative.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / history_days
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": 92,
      +  "description": "The number of calendar days before the Toolkit's end date to retrieve, never before its start date. None retrieves the Toolkit's whole date range (one download per trading day)."
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_analyst_estimates",
      -  "get_balance_sheet_statement",
      -  "get_cash_flow_statement",
      -  "get_commitment_of_traders",
      -  "get_company_notes",
      -  "get_dividend_calendar",
      -  "get_earnings_calendar",
      -  "get_earnings_call_transcripts",
      -  "get_employee_count",
      -  "get_executive_compensation",
      -  "get_executives",
      -  "get_historical_data",
      -  "get_historical_statistics",
      -  "get_income_statement",
      -  "get_insider_trade_statistics",
      -  "get_intraday_data",
      -  "get_market_risk_premium",
      -  "get_mergers_acquisitions",
      -  "get_profile",
      -  "get_quote",
      -  "get_rating",
      -  "get_revenue_geographic_segmentation",
      -  "get_revenue_product_segmentation",
      -  "get_shares_float",
      -  "get_statistics_statement",
      -  "get_stock_grades",
      -  "get_stock_splits",
      -  "get_treasury_data"
      -]New value: +[
      +  "get_analyst_estimates",
      +  "get_analyst_recommendations",
      +  "get_balance_sheet_statement",
      +  "get_cash_flow_statement",
      +  "get_commitment_of_traders",
      +  "get_company_notes",
      +  "get_dividend_calendar",
      +  "get_earnings_calendar",
      +  "get_earnings_call_transcripts",
      +  "get_earnings_surprise",
      +  "get_employee_count",
      +  "get_executive_compensation",
      +  "get_executives",
      +  "get_historical_data",
      +  "get_historical_statistics",
      +  "get_income_statement",
      +  "get_insider_trade_statistics",
      +  "get_institutional_ownership",
      +  "get_intraday_data",
      +  "get_market_risk_premium",
      +  "get_mergers_acquisitions",
      +  "get_price_target_history",
      +  "get_price_targets",
      +  "get_profile",
      +  "get_quote",
      +  "get_rating",
      +  "get_revenue_geographic_segmentation",
      +  "get_revenue_product_segmentation",
      +  "get_shares_float",
      +  "get_short_volume",
      +  "get_statistics_statement",
      +  "get_stock_grades",
      +  "get_stock_splits",
      +  "get_treasury_data"
      +]
    • 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."
    • addedInput schema / properties / sue_window
      Added value: +{
      +  "default": 8,
      +  "description": "The number of earlier announcements whose EPS surprises scale the SUE.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / window
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "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 are 1 for get_earnings_surprise; 20 for get_short_volume."
      +}
  4. 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)."
  5. Changed5 schema fields changedv2.3.0
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-14"New value: +"2026-10-27"
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_analyst_estimates",
      -  "get_balance_sheet_statement",
      -  "get_cash_flow_statement",
      -  "get_commitment_of_traders",
      -  "get_company_notes",
      -  "get_dividend_calendar",
      -  "get_earnings_calendar",
      -  "get_earnings_call_transcripts",
      -  "get_employee_count",
      -  "get_etf_country_weightings",
      -  "get_etf_holdings",
      -  "get_etf_information",
      -  "get_etf_sector_weightings",
      -  "get_executive_compensation",
      -  "get_executives",
      -  "get_historical_data",
      -  "get_historical_statistics",
      -  "get_income_statement",
      -  "get_insider_trade_statistics",
      -  "get_intraday_data",
      -  "get_market_risk_premium",
      -  "get_mergers_acquisitions",
      -  "get_profile",
      -  "get_quote",
      -  "get_rating",
      -  "get_revenue_geographic_segmentation",
      -  "get_revenue_product_segmentation",
      -  "get_shares_float",
      -  "get_statistics_statement",
      -  "get_stock_grades",
      -  "get_stock_splits",
      -  "get_treasury_data"
      -]New value: +[
      +  "get_analyst_estimates",
      +  "get_balance_sheet_statement",
      +  "get_cash_flow_statement",
      +  "get_commitment_of_traders",
      +  "get_company_notes",
      +  "get_dividend_calendar",
      +  "get_earnings_calendar",
      +  "get_earnings_call_transcripts",
      +  "get_employee_count",
      +  "get_executive_compensation",
      +  "get_executives",
      +  "get_historical_data",
      +  "get_historical_statistics",
      +  "get_income_statement",
      +  "get_insider_trade_statistics",
      +  "get_intraday_data",
      +  "get_market_risk_premium",
      +  "get_mergers_acquisitions",
      +  "get_profile",
      +  "get_quote",
      +  "get_rating",
      +  "get_revenue_geographic_segmentation",
      +  "get_revenue_product_segmentation",
      +  "get_shares_float",
      +  "get_statistics_statement",
      +  "get_stock_grades",
      +  "get_stock_splits",
      +  "get_treasury_data"
      +]
    • 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. Leave unset to use the default of the indicator you selected. Defaults are 25 for get_etf_holdings."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."
    • changedInput schema / properties / risk_free_rate / description
      Previous value: -"The maturity to return as the risk free rate ('13w', '5y', '10y' or '30y')."New value: +"One maturity to return ('13w', '5y', '10y' or '30y'). The Toolkit's own risk free rate stays the maturity set on the Toolkit either way."
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-15"New value: +"2021-10-28"
  6. Changed42 schema fields changedv2.2.3
    • changedInput schema / properties / actual_dates / description
      Previous value: -"Value for actual_dates."New value: +"Defines whether to return the actual dates or the corresponding quarters."
    • removedInput schema / properties / actual_dates / title
      Removed value: -"Actual Dates"
    • removedInput schema / properties / benchmark_ticker / title
      Removed value: -"Benchmark Ticker"
    • changedInput schema / properties / divide_ohlc_by / description
      Previous value: -"Value for divide_ohlc_by."New value: +"A value to divide the yields by. Treasury yields are published in percent, so this defaults to 100 to return decimals."
    • removedInput schema / properties / divide_ohlc_by / title
      Removed value: -"Divide Ohlc By"
    • 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"
    • changedInput schema / properties / enforce_source / description
      Previous value: -"Value for enforce_source."New value: +"For get_balance_sheet_statement, get_cash_flow_statement, get_income_statement, get_statistics_statement: Forces this specific call to use a given source, either \"FinancialModelingPrep\" or \"YahooFinance\". This takes precedence over the source set on the Toolkit itself, so one instance can pull historical data from the free Yahoo Finance source while still using a FinancialModelingPrep key for the... For get_historical_data: A string containing the historical source you wish to enforce. This can be either FinancialModelingPrep or YahooFinance. For get_treasury_data: Forces this specific call to use a given source, either \"FinancialModelingPrep\" or \"YahooFinance\". This takes precedence over the source set on the Toolkit itself."
    • removedInput schema / properties / enforce_source / title
      Removed value: -"Enforce Source"
    • changedInput schema / properties / fill_nan / description
      Previous value: -"Value for fill_nan."New value: +"For get_historical_data, get_treasury_data: Defines whether to forward fill NaN values. This defaults to True to prevent holes in the dataset. This is especially relevant for technical indicators. For get_intraday_data: Defines whether to forward fill NaN values."
    • removedInput schema / properties / fill_nan / title
      Removed value: -"Fill Nan"
    • addedInput schema / properties / fiscal_period
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The company's fiscal quarter, e.g. '2025Q4' (its own fiscal year, which differs from the calendar year for e.g. Apple and Microsoft). Leave unset for the most recent."
      +}
    • removedInput schema / properties / growth / title
      Removed value: -"Growth"
    • changedInput schema / properties / include_dividends / description
      Previous value: -"Value for include_dividends."New value: +"Defines whether to include dividends in the return calculation."
    • removedInput schema / properties / include_dividends / title
      Removed value: -"Include Dividends"
    • 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."
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_analyst_estimates",
      -  "get_balance_sheet_statement",
      -  "get_cash_flow_statement",
      -  "get_commitment_of_traders",
      -  "get_dividend_calendar",
      -  "get_earnings_calendar",
      -  "get_historical_data",
      -  "get_historical_statistics",
      -  "get_income_statement",
      -  "get_intraday_data",
      -  "get_market_risk_premium",
      -  "get_profile",
      -  "get_quote",
      -  "get_rating",
      -  "get_revenue_geographic_segmentation",
      -  "get_revenue_product_segmentation",
      -  "get_statistics_statement",
      -  "get_treasury_data"
      -]New value: +[
      +  "get_analyst_estimates",
      +  "get_balance_sheet_statement",
      +  "get_cash_flow_statement",
      +  "get_commitment_of_traders",
      +  "get_company_notes",
      +  "get_dividend_calendar",
      +  "get_earnings_calendar",
      +  "get_earnings_call_transcripts",
      +  "get_employee_count",
      +  "get_etf_country_weightings",
      +  "get_etf_holdings",
      +  "get_etf_information",
      +  "get_etf_sector_weightings",
      +  "get_executive_compensation",
      +  "get_executives",
      +  "get_historical_data",
      +  "get_historical_statistics",
      +  "get_income_statement",
      +  "get_insider_trade_statistics",
      +  "get_intraday_data",
      +  "get_market_risk_premium",
      +  "get_mergers_acquisitions",
      +  "get_profile",
      +  "get_quote",
      +  "get_rating",
      +  "get_revenue_geographic_segmentation",
      +  "get_revenue_product_segmentation",
      +  "get_shares_float",
      +  "get_statistics_statement",
      +  "get_stock_grades",
      +  "get_stock_splits",
      +  "get_treasury_data"
      +]
    • 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"
    • addedInput schema / properties / latest
      Added value: +{
      +  "default": true,
      +  "description": "Whether to only retrieve the most recent transcript. When False, every transcript between the start_date and end_date is retrieved.",
      +  "type": "boolean"
      +}
    • 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. Leave unset to use the default of the indicator you selected. Defaults are 25 for get_etf_holdings."
      +}
    • changedInput schema / properties / period / description
      Previous value: -"Observation frequency, e.g. 'monthly', 'quarterly', or 'annual'. Leave unset to use the default of the indicator you selected. Defaults are 'daily' for get_historical_data, get_treasury_data; '1hour' for get_intraday_data."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 are 'daily' for get_historical_data, get_treasury_data; '1hour' for get_intraday_data."
    • removedInput schema / properties / period / title
      Removed value: -"Period"
    • removedInput schema / properties / quarterly / title
      Removed value: -"Quarterly"
    • changedInput schema / properties / return_column / description
      Previous value: -"Value for return_column. Leave unset to use the default of the indicator you selected. Defaults are 'Adj Close' for get_historical_data; 'Close' for get_intraday_data."New value: +"The column to use for the return calculation. Leave unset to use the default of the indicator you selected. Defaults are 'Adj Close' for get_historical_data; 'Close' for get_intraday_data."
    • removedInput schema / properties / return_column / title
      Removed value: -"Return Column"
    • changedInput schema / properties / risk_free_rate / description
      Previous value: -"Value for risk_free_rate."New value: +"The maturity to return as the risk free rate ('13w', '5y', '10y' or '30y')."
    • removedInput schema / properties / risk_free_rate / title
      Removed value: -"Risk Free Rate"
    • removedInput schema / properties / show_columns / title
      Removed value: -"Show Columns"
    • changedInput schema / properties / show_errors / description
      Previous value: -"Value for show_errors."New value: +"Whether to report retrieval errors."
    • removedInput schema / properties / show_errors / title
      Removed value: -"Show Errors"
    • changedInput schema / properties / show_ticker_seperation / description
      Previous value: -"Value for show_ticker_seperation."New value: +"A boolean representing whether to show which tickers acquired data from FinancialModelingPrep and which tickers acquired data from YahooFinance."
    • removedInput schema / properties / show_ticker_seperation / title
      Removed value: -"Show Ticker Seperation"
    • 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"
    • removedInput schema / properties / trailing / title
      Removed value: -"Trailing"
    • removedInput schema / title
      Removed value: -"market_dataArguments"
  7. 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"
  8. Changed11 schema fields changedv2.2.0
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-14"New value: +"2026-08-19"
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_analyst_estimates",
      -  "get_balance_sheet_statement",
      -  "get_cash_flow_statement",
      -  "get_dividend_calendar",
      -  "get_earnings_calendar",
      -  "get_historical_data",
      -  "get_historical_statistics",
      -  "get_income_statement",
      -  "get_intraday_data",
      -  "get_profile",
      -  "get_quote",
      -  "get_rating",
      -  "get_revenue_geographic_segmentation",
      -  "get_revenue_product_segmentation",
      -  "get_statistics_statement",
      -  "get_treasury_data"
      -]New value: +[
      +  "get_analyst_estimates",
      +  "get_balance_sheet_statement",
      +  "get_cash_flow_statement",
      +  "get_commitment_of_traders",
      +  "get_dividend_calendar",
      +  "get_earnings_calendar",
      +  "get_historical_data",
      +  "get_historical_statistics",
      +  "get_income_statement",
      +  "get_intraday_data",
      +  "get_market_risk_premium",
      +  "get_profile",
      +  "get_quote",
      +  "get_rating",
      +  "get_revenue_geographic_segmentation",
      +  "get_revenue_product_segmentation",
      +  "get_statistics_statement",
      +  "get_treasury_data"
      +]
    • 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. 'monthly', 'quarterly', or 'annual'."New value: +"Observation frequency, e.g. 'monthly', 'quarterly', or 'annual'. Leave unset to use the default of the indicator you selected. Defaults are 'daily' for get_historical_data, get_treasury_data; '1hour' for get_intraday_data."
    • removedInput schema / properties / period / type
      Removed value: -"string"
    • addedInput schema / properties / return_column / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / return_column / default
      Previous value: -"Adj Close"New value: +null
    • changedInput schema / properties / return_column / description
      Previous value: -"Value for return_column."New value: +"Value for return_column. Leave unset to use the default of the indicator you selected. Defaults are 'Adj Close' for get_historical_data; 'Close' for get_intraday_data."
    • removedInput schema / properties / return_column / type
      Removed value: -"string"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-15"New value: +"2021-08-20"
  9. Changed3 schema fields changed
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-09"New value: +"2026-07-14"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-10"New value: +"2021-07-15"
    • changedInput schema / properties / trailing / description
      Previous value: -"Number of trailing periods for rolling-window calculations."New value: +"Trailing window size in number of periods. Sums the raw values over the trailing N periods (e.g. trailing=4 on quarterly data gives a trailing-4-quarter / TTM-style sum) instead of returning one value per period."
  10. 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"
  11. 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"
  12. 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"
  13. Changed2 schema fields changedv0.1.1
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-21"New value: +"2026-06-22"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-22"New value: +"2021-06-23"
  14. First observedv0.1.0

TDQS

A3.9/5.0
Behavior5/5

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

With annotations already declaring read-only, open-world, and idempotent behavior, the description still adds substantial context: basket=true sums statements into a Total with per-share fields empty, transcripts can be 40,000–60,000 characters and fall back to recent periods, short volume is FINRA daily short sale volume rather than short interest, and price-target outputs include upside, dispersion, and revision momentum. These details go well beyond the annotations and materially help an agent use the tool correctly.

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

Conciseness2/5

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

The definition is a single dense paragraph with deeply nested parentheticals and long enumerations, making it difficult to scan. Although many details are useful, it is not front-loaded or structured for a 29-parameter, 34-indicator tool, and an agent must parse a wall of text to extract the routing rules.

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?

For a very complex multi-indicator tool, the description covers many important edge cases such as transcript length and fallback, basket totals, market-wide calls, short-volume semantics, and currency/crypto pair formats, and an output schema exists. However, several enum indicators are only mentioned by name and lack indicator-specific behavior, so an agent may still need trial calls or other documentation for those cases.

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 description coverage is 100%, so parameters like lag, rank, limit, growth, compound, and show_columns are already well documented. The description adds useful indicator-specific semantics: tickers are required as comma-separated values for most indicators, basket changes statement totals, get_commitment_of_traders takes CFTC symbols, history_days drives get_short_volume, and fiscal_period selects a transcript. It does not add much beyond the schema for many general parameters, but it compensates for the multi-indicator enum by explaining key indicator-specific inputs.

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 'Raw financial data' and enumerates dataset families such as historical prices, statements, calendars, ownership, and short volume, so the resource is identifiable. It also distinguishes this tool from dedicated tools for pre-computed ratios, performance, risk, or model metrics and points ETF holdings to the etf tool, though the broad indicator list makes the boundary less crisp than a single-purpose tool.

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 gives an explicit when-not rule: 'Use this ONLY for raw data needs — for pre-computed ratios, performance, risk, or model metrics use the dedicated tools instead.' It also identifies market-wide indicators that need no tickers and explains that get_commitment_of_traders takes CFTC symbols, but it does not systematically name or compare each alternative sibling such as performance, risk, valuation, or rates.

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