Skip to main content
Glama
Finance Toolkit

Finance Toolkit

discovery

Read-onlyIdempotent

Find market-wide lists, screeners, calendars, filings, insider trades, and news for stocks, ETFs, indices, currencies, commodities, and crypto without tickers or countries.

Instructions

Market discovery (lists of stocks, ETFs, indices, currencies, commodities and cryptocurrencies, stock screener, biggest gainers and losers, most active stocks, sector and industry performance and P/E, earnings, IPO and stock split calendars, latest 8-K filings, insider trades and mergers, market news and press releases). No tickers or countries needed. The news and press release feeds (get_stock_news, get_press_releases, get_general_news, get_crypto_news, get_forex_news) are the latest articles across the whole market, not news about one company: each article names its ticker, but the feed cannot be narrowed to a ticker. The calendars and filings take start_date/end_date; the market-wide earnings calendar (get_earnings_calendar) covers the coming week unless a range is given and lists the largest companies first, one row per company (its primary, most traded listing; share classes with names of their own count as separate companies) with 'Market Cap (USD)'; min_market_cap= (in US dollars), country= (the company's country) and exchange= (e.g. 'XETRA') narrow it, sort_by='date' sorts by date and primary_only=false shows every listing. Its EPS and revenue are in the currency the source reports for each listing. Sector and industry performance and P/E take date= for one day's snapshot or sector=/industry= for a history (the last year unless start_date/end_date say otherwise); they average the companies of one exchange, exchange='NASDAQ' (default), 'NYSE' or 'AMEX', and performance is a decimal change (0.0125 is +1.25%). The stock screener ranks by market cap in US dollars ('Market Cap (USD)'; 'Market Cap' is in the listing's own currency) and returns every listing of a company unless primary_only=true; to screen by classification, use the Finance Database server. get_index_constituents lists the members of index='S&P 500', 'NASDAQ 100' or 'Dow Jones', today's or, with date=, those on a past date (with the date each left the index), free of survivorship bias; get_index_constituent_changes lists the dated additions and removals with their reasons (start_date/end_date). get_industry_statistics returns Aswath Damodaran's industry averages (about 95 industries plus the Total Market, computed every January from all listed companies): dataset='cost_of_capital' (default; beta, cost of equity and debt, debt weights, WACC), 'betas' (levered and unlevered betas, the unlevered beta corrected for cash, D/E ratio), 'total_betas', 'margins', 'price_to_earnings', 'price_to_book', 'price_to_sales' or 'enterprise_value_multiples', for region='United States' (default), 'Europe', 'Japan', 'Australia, New Zealand and Canada', 'Emerging Markets', 'China', 'India' or 'Global'; rates and margins are decimals, betas and multiples plain numbers. Use show_columns to keep a few columns.

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

Input Schema

NameRequiredDescriptionDefault
dateNoFor get_index_constituents: The date (YYYY-MM-DD) to list the members of. A change takes effect on its own date, so the members on a change's date include it. For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance: The date to retrieve a snapshot for, e.g. "2024-02-01". For get_insider_trading_latest: Only return the trades filed on this date.
pageNoFor get_delisted_stocks: The page of results to retrieve, starting at 0. For get_insider_trading_latest, get_mergers_acquisitions_latest, get_sec_filings_8k: The page number to retrieve.
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.
indexNo"S&P 500", "NASDAQ 100" or "Dow Jones".S&P 500
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. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_insider_trading_latest, get_mergers_acquisitions_latest, get_press_releases, get_sec_filings_8k, get_stock_news; 1000 for get_stock_screener.
pagesNoThe number of pages to collect, each page is a separate API call, e.g. pages=5 makes 5 calls.
is_etfNoWhether to restrict the screen to ETFs or to exclude them.
regionNoThe region: "United States", "Europe", "Japan", "Australia, New Zealand and Canada", "Emerging Markets", "China", "India" or "Global".United States
sectorNoFor get_sector_pe, get_sector_performance: The sector to retrieve the history for, e.g. "Energy". For get_stock_screener: The sector to restrict the screen to, e.g. "Energy".
countryNoFor get_earnings_calendar: The country of the company, as a two-letter code ("DE") or a name ("Germany"). It is looked up with the company screener, which returns at most 10,000 listings, largest first, so for the United States without a min_market_cap the smallest companies can be missing. For get_stock_screener: The country to restrict the screen to, as a two-letter code ("US") or a name ("United States").
datasetNoThe dataset: "betas", "total_betas", "cost_of_capital", "margins", "price_to_earnings", "price_to_book", "price_to_sales" or "enterprise_value_multiples".cost_of_capital
sort_byNo"date" to sort by date and symbol, or "market_cap" to put the largest companies first. Leave unset to use the default of the indicator you selected. Defaults are 'market_cap' for get_earnings_calendar.
end_dateNoEnd of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window).
exchangeNoFor get_earnings_calendar: The exchange code of the listing, such as "NASDAQ" or "XETRA". For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance: The exchange whose companies are averaged, "NASDAQ", "NYSE" or "AMEX". For get_stock_screener: The exchange code to restrict the screen to, e.g. "NASDAQ". Leave unset to use the default of the indicator you selected. Defaults are 'NASDAQ' for get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance; None for get_earnings_calendar, get_stock_screener.
industryNoFor get_industry_pe, get_industry_performance: The industry to retrieve the history for, e.g. "Biotechnology". For get_stock_screener: The industry to restrict the screen to, e.g. "Biotechnology".
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.
beta_lowerNoThe maximum beta of the stock.
start_dateNoStart of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window).
beta_higherNoThe minimum beta of the stock.
price_lowerNoThe maximum price of the stock.
price_higherNoThe minimum price of the stock.
primary_onlyNoSet to true to keep only the most traded listing of each company rather than every listing (e.g. ING in Amsterdam, New York, Toronto and Frankfurt). Leave unset to use the default of the indicator you selected. Defaults are False for get_stock_screener; True for get_earnings_calendar.
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.
volume_lowerNoThe maximum volume of the stock.
volume_higherNoThe minimum volume of the stock, in shares traded.
dividend_lowerNoThe maximum dividend of the stock.
min_market_capNoThe minimum market cap in US dollars, such as 10e9 for ten billion. Releases without a market cap are left out.
dividend_higherNoThe minimum dividend of the stock, as an amount per share over the last annual period rather than as a yield.
market_cap_lowerNoThe maximum market capitalization of the stock in US dollars. The screener returns the largest companies first, so this bound is only sent to it when the currency of the listings is known: with an exchange, or with a country and primary_only. Otherwise it is applied to the companies returned.
market_cap_higherNoThe minimum market capitalization of the stock in US dollars (not in millions), e.g. 1_000_000_000 for $1 billion.

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. Changed8 schema fields changedv2.3.3
    • changedInput schema / properties / country / description
      Previous value: -"The country to restrict the screen to, as a two-letter code (\"US\") or a name (\"United States\")."New value: +"For get_earnings_calendar: The country of the company, as a two-letter code (\"DE\") or a name (\"Germany\"). It is looked up with the company screener, which returns at most 10,000 listings, largest first, so for the United States without a min_market_cap the smallest companies can be missing. For get_stock_screener: The country to restrict the screen to, as a two-letter code (\"US\") or a name (\"United States\")."
    • changedInput schema / properties / exchange / description
      Previous value: -"For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance: The exchange whose companies are averaged, \"NASDAQ\", \"NYSE\" or \"AMEX\". For get_stock_screener: The exchange code to restrict the screen to, e.g. \"NASDAQ\". Leave unset to use the default of the indicator you selected. Defaults are 'NASDAQ' for get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance; None for get_stock_screener."New value: +"For get_earnings_calendar: The exchange code of the listing, such as \"NASDAQ\" or \"XETRA\". For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance: The exchange whose companies are averaged, \"NASDAQ\", \"NYSE\" or \"AMEX\". For get_stock_screener: The exchange code to restrict the screen to, e.g. \"NASDAQ\". Leave unset to use the default of the indicator you selected. Defaults are 'NASDAQ' for get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance; None for get_earnings_calendar, get_stock_screener."
    • addedInput schema / properties / min_market_cap
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The minimum market cap in US dollars, such as 10e9 for ten billion. Releases without a market cap are left out."
      +}
    • addedInput schema / properties / primary_only / anyOf
      Added value: +[
      +  {
      +    "type": "boolean"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / primary_only / default
      Previous value: -falseNew value: +null
    • changedInput schema / properties / primary_only / description
      Previous value: -"Set to true to keep only the most traded listing of each company rather than every listing (e.g. ING in Amsterdam, New York, Toronto and Frankfurt)."New value: +"Set to true to keep only the most traded listing of each company rather than every listing (e.g. ING in Amsterdam, New York, Toronto and Frankfurt). Leave unset to use the default of the indicator you selected. Defaults are False for get_stock_screener; True for get_earnings_calendar."
    • removedInput schema / properties / primary_only / type
      Removed value: -"boolean"
    • addedInput schema / properties / sort_by
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "\"date\" to sort by date and symbol, or \"market_cap\" to put the largest companies first. Leave unset to use the default of the indicator you selected. Defaults are 'market_cap' for get_earnings_calendar."
      +}
  3. Changed5 schema fields changedv2.3.2
    • addedInput schema / properties / dataset
      Added value: +{
      +  "default": "cost_of_capital",
      +  "description": "The dataset: \"betas\", \"total_betas\", \"cost_of_capital\", \"margins\", \"price_to_earnings\", \"price_to_book\", \"price_to_sales\" or \"enterprise_value_multiples\".",
      +  "type": "string"
      +}
    • changedInput schema / properties / date / description
      Previous value: -"For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance: The date to retrieve a snapshot for, e.g. \"2024-02-01\". For get_insider_trading_latest: Only return the trades filed on this date."New value: +"For get_index_constituents: The date (YYYY-MM-DD) to list the members of. A change takes effect on its own date, so the members on a change's date include it. For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance: The date to retrieve a snapshot for, e.g. \"2024-02-01\". For get_insider_trading_latest: Only return the trades filed on this date."
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_biggest_gainers",
      -  "get_biggest_losers",
      -  "get_commodity_list",
      -  "get_crypto_list",
      -  "get_crypto_news",
      -  "get_delisted_stocks",
      -  "get_earnings_calendar",
      -  "get_etf_list",
      -  "get_forex_list",
      -  "get_forex_news",
      -  "get_general_news",
      -  "get_index_constituents",
      -  "get_index_list",
      -  "get_industry_pe",
      -  "get_industry_performance",
      -  "get_insider_trading_latest",
      -  "get_ipo_calendar",
      -  "get_ipo_disclosures",
      -  "get_ipo_prospectuses",
      -  "get_mergers_acquisitions_latest",
      -  "get_most_active_stocks",
      -  "get_press_releases",
      -  "get_sec_filings_8k",
      -  "get_sector_pe",
      -  "get_sector_performance",
      -  "get_sectors_performance",
      -  "get_stock_list",
      -  "get_stock_news",
      -  "get_stock_screener",
      -  "get_stock_shares_float",
      -  "get_stock_splits_calendar"
      -]New value: +[
      +  "get_biggest_gainers",
      +  "get_biggest_losers",
      +  "get_commodity_list",
      +  "get_crypto_list",
      +  "get_crypto_news",
      +  "get_delisted_stocks",
      +  "get_earnings_calendar",
      +  "get_etf_list",
      +  "get_forex_list",
      +  "get_forex_news",
      +  "get_general_news",
      +  "get_index_constituent_changes",
      +  "get_index_constituents",
      +  "get_index_list",
      +  "get_industry_pe",
      +  "get_industry_performance",
      +  "get_industry_statistics",
      +  "get_insider_trading_latest",
      +  "get_ipo_calendar",
      +  "get_ipo_disclosures",
      +  "get_ipo_prospectuses",
      +  "get_mergers_acquisitions_latest",
      +  "get_most_active_stocks",
      +  "get_press_releases",
      +  "get_sec_filings_8k",
      +  "get_sector_pe",
      +  "get_sector_performance",
      +  "get_sectors_performance",
      +  "get_stock_list",
      +  "get_stock_news",
      +  "get_stock_screener",
      +  "get_stock_shares_float",
      +  "get_stock_splits_calendar"
      +]
    • 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. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_insider_trading_latest, get_mergers_acquisitions_latest, get_press_releases, get_sec_filings_8k, get_stock_news; 1000 for get_stock_screener."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. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_insider_trading_latest, get_mergers_acquisitions_latest, get_press_releases, get_sec_filings_8k, get_stock_news; 1000 for get_stock_screener."
    • addedInput schema / properties / region
      Added value: +{
      +  "default": "United States",
      +  "description": "The region: \"United States\", \"Europe\", \"Japan\", \"Australia, New Zealand and Canada\", \"Emerging Markets\", \"China\", \"India\" or \"Global\".",
      +  "type": "string"
      +}
  4. Changed5 schema fields changedv2.3.1
    • changedInput schema / properties / country / description
      Previous value: -"The two-letter country code to restrict the screen to, e.g. \"US\"."New value: +"The country to restrict the screen to, as a two-letter code (\"US\") or a name (\"United States\")."
    • 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. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_insider_trading_latest, get_mergers_acquisitions_latest, get_press_releases, get_sec_filings_8k, get_stock_news; 1000 for get_stock_screener."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. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_insider_trading_latest, get_mergers_acquisitions_latest, get_press_releases, get_sec_filings_8k, get_stock_news; 1000 for get_stock_screener."
    • changedInput schema / properties / market_cap_lower / description
      Previous value: -"The maximum market capitalization of the stock in US dollars."New value: +"The maximum market capitalization of the stock in US dollars. The screener returns the largest companies first, so this bound is only sent to it when the currency of the listings is known: with an exchange, or with a country and primary_only. Otherwise it is applied to the companies returned."
    • 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. Changed11 schema fields changedv2.3.0
    • changedInput schema / properties / beta_higher / anyOf
      Previous value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / beta_lower / anyOf
      Previous value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / dividend_higher / anyOf
      Previous value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / dividend_lower / anyOf
      Previous value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / exchange / description
      Previous value: -"The exchange code to restrict the screen to, e.g. \"NASDAQ\"."New value: +"For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance: The exchange whose companies are averaged, \"NASDAQ\", \"NYSE\" or \"AMEX\". For get_stock_screener: The exchange code to restrict the screen to, e.g. \"NASDAQ\". Leave unset to use the default of the indicator you selected. Defaults are 'NASDAQ' for get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance, get_sectors_performance; None for get_stock_screener."
    • addedInput schema / properties / index
      Added value: +{
      +  "default": "S&P 500",
      +  "description": "\"S&P 500\", \"NASDAQ 100\" or \"Dow Jones\".",
      +  "type": "string"
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_biggest_gainers",
      -  "get_biggest_losers",
      -  "get_commodity_list",
      -  "get_crypto_list",
      -  "get_crypto_news",
      -  "get_delisted_stocks",
      -  "get_earnings_calendar",
      -  "get_etf_list",
      -  "get_forex_list",
      -  "get_forex_news",
      -  "get_general_news",
      -  "get_index_list",
      -  "get_industry_pe",
      -  "get_industry_performance",
      -  "get_insider_trading_latest",
      -  "get_ipo_calendar",
      -  "get_ipo_disclosures",
      -  "get_ipo_prospectuses",
      -  "get_mergers_acquisitions_latest",
      -  "get_most_active_stocks",
      -  "get_press_releases",
      -  "get_sec_filings_8k",
      -  "get_sector_pe",
      -  "get_sector_performance",
      -  "get_sectors_performance",
      -  "get_stock_list",
      -  "get_stock_news",
      -  "get_stock_screener",
      -  "get_stock_shares_float",
      -  "get_stock_splits_calendar"
      -]New value: +[
      +  "get_biggest_gainers",
      +  "get_biggest_losers",
      +  "get_commodity_list",
      +  "get_crypto_list",
      +  "get_crypto_news",
      +  "get_delisted_stocks",
      +  "get_earnings_calendar",
      +  "get_etf_list",
      +  "get_forex_list",
      +  "get_forex_news",
      +  "get_general_news",
      +  "get_index_constituents",
      +  "get_index_list",
      +  "get_industry_pe",
      +  "get_industry_performance",
      +  "get_insider_trading_latest",
      +  "get_ipo_calendar",
      +  "get_ipo_disclosures",
      +  "get_ipo_prospectuses",
      +  "get_mergers_acquisitions_latest",
      +  "get_most_active_stocks",
      +  "get_press_releases",
      +  "get_sec_filings_8k",
      +  "get_sector_pe",
      +  "get_sector_performance",
      +  "get_sectors_performance",
      +  "get_stock_list",
      +  "get_stock_news",
      +  "get_stock_screener",
      +  "get_stock_shares_float",
      +  "get_stock_splits_calendar"
      +]
    • changedInput schema / properties / market_cap_higher / description
      Previous value: -"The minimum market capitalization of the stock, in the currency of the listing rather than in millions."New value: +"The minimum market capitalization of the stock in US dollars (not in millions), e.g. 1_000_000_000 for $1 billion."
    • changedInput schema / properties / market_cap_lower / description
      Previous value: -"The maximum market capitalization of the stock."New value: +"The maximum market capitalization of the stock in US dollars."
    • changedInput schema / properties / price_higher / anyOf
      Previous value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / price_lower / anyOf
      Previous value: -[
      -  {
      -    "type": "integer"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  6. Changed46 schema fields changedv2.2.3
    • changedInput schema / properties / beta_higher / description
      Previous value: -"Value for beta_higher."New value: +"The minimum beta of the stock."
    • removedInput schema / properties / beta_higher / title
      Removed value: -"Beta Higher"
    • changedInput schema / properties / beta_lower / description
      Previous value: -"Value for beta_lower."New value: +"The maximum beta of the stock."
    • removedInput schema / properties / beta_lower / title
      Removed value: -"Beta Lower"
    • changedInput schema / properties / country / description
      Previous value: -"Value for country."New value: +"The two-letter country code to restrict the screen to, e.g. \"US\"."
    • removedInput schema / properties / country / title
      Removed value: -"Country"
    • changedInput schema / properties / date / description
      Previous value: -"Value for date."New value: +"For get_industry_pe, get_industry_performance, get_sector_pe, get_sector_performance: The date to retrieve a snapshot for, e.g. \"2024-02-01\". For get_insider_trading_latest: Only return the trades filed on this date."
    • removedInput schema / properties / date / title
      Removed value: -"Date"
    • changedInput schema / properties / dividend_higher / description
      Previous value: -"Value for dividend_higher."New value: +"The minimum dividend of the stock, as an amount per share over the last annual period rather than as a yield."
    • removedInput schema / properties / dividend_higher / title
      Removed value: -"Dividend Higher"
    • changedInput schema / properties / dividend_lower / description
      Previous value: -"Value for dividend_lower."New value: +"The maximum dividend of the stock."
    • removedInput schema / properties / dividend_lower / title
      Removed value: -"Dividend Lower"
    • addedInput schema / properties / end_date
      Added value: +{
      +  "default": "",
      +  "description": "End of the date range in YYYY-MM-DD format.",
      +  "type": "string"
      +}
    • changedInput schema / properties / exchange / description
      Previous value: -"Value for exchange."New value: +"The exchange code to restrict the screen to, e.g. \"NASDAQ\"."
    • removedInput schema / properties / exchange / title
      Removed value: -"Exchange"
    • 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_biggest_gainers",
      -  "get_biggest_losers",
      -  "get_commodity_list",
      -  "get_crypto_list",
      -  "get_crypto_news",
      -  "get_delisted_stocks",
      -  "get_etf_list",
      -  "get_forex_list",
      -  "get_forex_news",
      -  "get_general_news",
      -  "get_index_list",
      -  "get_industry_pe",
      -  "get_industry_performance",
      -  "get_ipo_calendar",
      -  "get_ipo_disclosures",
      -  "get_ipo_prospectuses",
      -  "get_mergers_acquisitions_latest",
      -  "get_most_active_stocks",
      -  "get_press_releases",
      -  "get_sector_pe",
      -  "get_sector_performance",
      -  "get_sectors_performance",
      -  "get_stock_list",
      -  "get_stock_news",
      -  "get_stock_screener",
      -  "get_stock_shares_float",
      -  "get_stock_splits_calendar"
      -]New value: +[
      +  "get_biggest_gainers",
      +  "get_biggest_losers",
      +  "get_commodity_list",
      +  "get_crypto_list",
      +  "get_crypto_news",
      +  "get_delisted_stocks",
      +  "get_earnings_calendar",
      +  "get_etf_list",
      +  "get_forex_list",
      +  "get_forex_news",
      +  "get_general_news",
      +  "get_index_list",
      +  "get_industry_pe",
      +  "get_industry_performance",
      +  "get_insider_trading_latest",
      +  "get_ipo_calendar",
      +  "get_ipo_disclosures",
      +  "get_ipo_prospectuses",
      +  "get_mergers_acquisitions_latest",
      +  "get_most_active_stocks",
      +  "get_press_releases",
      +  "get_sec_filings_8k",
      +  "get_sector_pe",
      +  "get_sector_performance",
      +  "get_sectors_performance",
      +  "get_stock_list",
      +  "get_stock_news",
      +  "get_stock_screener",
      +  "get_stock_shares_float",
      +  "get_stock_splits_calendar"
      +]
    • removedInput schema / properties / indicator / title
      Removed value: -"Indicator"
    • changedInput schema / properties / industry / description
      Previous value: -"Value for industry."New value: +"For get_industry_pe, get_industry_performance: The industry to retrieve the history for, e.g. \"Biotechnology\". For get_stock_screener: The industry to restrict the screen to, e.g. \"Biotechnology\"."
    • removedInput schema / properties / industry / title
      Removed value: -"Industry"
    • changedInput schema / properties / is_etf / description
      Previous value: -"Value for is_etf."New value: +"Whether to restrict the screen to ETFs or to exclude them."
    • removedInput schema / properties / is_etf / title
      Removed value: -"Is Etf"
    • changedInput schema / properties / limit / description
      Previous value: -"Value for limit. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_mergers_acquisitions_latest, get_press_releases, get_stock_news; 1000 for get_stock_screener."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. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_insider_trading_latest, get_mergers_acquisitions_latest, get_press_releases, get_sec_filings_8k, get_stock_news; 1000 for get_stock_screener."
    • removedInput schema / properties / limit / title
      Removed value: -"Limit"
    • changedInput schema / properties / market_cap_higher / description
      Previous value: -"Value for market_cap_higher."New value: +"The minimum market capitalization of the stock, in the currency of the listing rather than in millions."
    • removedInput schema / properties / market_cap_higher / title
      Removed value: -"Market Cap Higher"
    • changedInput schema / properties / market_cap_lower / description
      Previous value: -"Value for market_cap_lower."New value: +"The maximum market capitalization of the stock."
    • removedInput schema / properties / market_cap_lower / title
      Removed value: -"Market Cap Lower"
    • changedInput schema / properties / page / description
      Previous value: -"Value for page."New value: +"For get_delisted_stocks: The page of results to retrieve, starting at 0. For get_insider_trading_latest, get_mergers_acquisitions_latest, get_sec_filings_8k: The page number to retrieve."
    • removedInput schema / properties / page / title
      Removed value: -"Page"
    • changedInput schema / properties / pages / description
      Previous value: -"Value for pages."New value: +"The number of pages to collect, each page is a separate API call, e.g. pages=5 makes 5 calls."
    • removedInput schema / properties / pages / title
      Removed value: -"Pages"
    • changedInput schema / properties / price_higher / description
      Previous value: -"Value for price_higher."New value: +"The minimum price of the stock."
    • removedInput schema / properties / price_higher / title
      Removed value: -"Price Higher"
    • changedInput schema / properties / price_lower / description
      Previous value: -"Value for price_lower."New value: +"The maximum price of the stock."
    • removedInput schema / properties / price_lower / title
      Removed value: -"Price Lower"
    • addedInput schema / properties / primary_only
      Added value: +{
      +  "default": false,
      +  "description": "Set to true to keep only the most traded listing of each company rather than every listing (e.g. ING in Amsterdam, New York, Toronto and Frankfurt).",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / sector / description
      Previous value: -"Value for sector."New value: +"For get_sector_pe, get_sector_performance: The sector to retrieve the history for, e.g. \"Energy\". For get_stock_screener: The sector to restrict the screen to, e.g. \"Energy\"."
    • removedInput schema / properties / sector / title
      Removed value: -"Sector"
    • removedInput schema / properties / show_columns / title
      Removed value: -"Show Columns"
    • addedInput schema / properties / start_date
      Added value: +{
      +  "default": "",
      +  "description": "Start of the date range in YYYY-MM-DD format.",
      +  "type": "string"
      +}
    • changedInput schema / properties / volume_higher / description
      Previous value: -"Value for volume_higher."New value: +"The minimum volume of the stock, in shares traded."
    • removedInput schema / properties / volume_higher / title
      Removed value: -"Volume Higher"
    • changedInput schema / properties / volume_lower / description
      Previous value: -"Value for volume_lower."New value: +"The maximum volume of the stock."
    • removedInput schema / properties / volume_lower / title
      Removed value: -"Volume Lower"
    • removedInput schema / title
      Removed value: -"discoveryArguments"
  7. Changed6 schema fields changedv2.2.0
    • addedInput schema / properties / country
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for country.",
      +  "title": "Country"
      +}
    • addedInput schema / properties / exchange
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for exchange.",
      +  "title": "Exchange"
      +}
    • addedInput schema / properties / limit / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / limit / default
      Previous value: -100New value: +null
    • changedInput schema / properties / limit / description
      Previous value: -"Value for limit."New value: +"Value for limit. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_crypto_news, get_delisted_stocks, get_forex_news, get_general_news, get_mergers_acquisitions_latest, get_press_releases, get_stock_news; 1000 for get_stock_screener."
    • removedInput schema / properties / limit / type
      Removed value: -"integer"
  8. Changed7 schema fields changed
    • addedInput schema / properties / date
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for date.",
      +  "title": "Date"
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_biggest_gainers",
      -  "get_biggest_losers",
      -  "get_commodity_list",
      -  "get_crypto_list",
      -  "get_delisted_stocks",
      -  "get_etf_list",
      -  "get_forex_list",
      -  "get_index_list",
      -  "get_most_active_stocks",
      -  "get_sectors_performance",
      -  "get_stock_list",
      -  "get_stock_screener",
      -  "get_stock_shares_float"
      -]New value: +[
      +  "get_biggest_gainers",
      +  "get_biggest_losers",
      +  "get_commodity_list",
      +  "get_crypto_list",
      +  "get_crypto_news",
      +  "get_delisted_stocks",
      +  "get_etf_list",
      +  "get_forex_list",
      +  "get_forex_news",
      +  "get_general_news",
      +  "get_index_list",
      +  "get_industry_pe",
      +  "get_industry_performance",
      +  "get_ipo_calendar",
      +  "get_ipo_disclosures",
      +  "get_ipo_prospectuses",
      +  "get_mergers_acquisitions_latest",
      +  "get_most_active_stocks",
      +  "get_press_releases",
      +  "get_sector_pe",
      +  "get_sector_performance",
      +  "get_sectors_performance",
      +  "get_stock_list",
      +  "get_stock_news",
      +  "get_stock_screener",
      +  "get_stock_shares_float",
      +  "get_stock_splits_calendar"
      +]
    • addedInput schema / properties / industry
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for industry.",
      +  "title": "Industry"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "default": 100,
      +  "description": "Value for limit.",
      +  "title": "Limit",
      +  "type": "integer"
      +}
    • addedInput schema / properties / page
      Added value: +{
      +  "default": 0,
      +  "description": "Value for page.",
      +  "title": "Page",
      +  "type": "integer"
      +}
    • addedInput schema / properties / pages
      Added value: +{
      +  "default": 1,
      +  "description": "Value for pages.",
      +  "title": "Pages",
      +  "type": "integer"
      +}
    • addedInput schema / properties / sector
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for sector.",
      +  "title": "Sector"
      +}
  9. Changed1 schema field changedv0.1.2
    • 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"
      +}
  10. Addedv0.1.1

TDQS

A4.1/5.0
Behavior5/5

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

Beyond the readOnly/openWorld/idempotent annotations, the description discloses substantial operational behavior: default date windows, that index constituents are survivorship-bias-free, that sector/industry performance averages one exchange's companies and reports performance as a decimal change, that industry statistics come from Damodaran and are computed every January, and that the screener returns every listing unless primary_only=true. These details materially help an agent call the tool correctly and interpret results.

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 description is a single dense paragraph that runs many distinct indicator behaviors together with semicolons, making it hard to scan despite the large amount of justified detail. It is front-loaded with the catalog of content, but better grouping or line breaks would make the per-indicator guidance more usable.

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

Completeness4/5

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

For a 30-parameter tool with 34 indicator values, the description covers the trickiest indicators in helpful detail (news, earnings calendar, index constituents, industry statistics, screener, sector/industry performance) and relies on the 100%-covered schema and output schema for the rest. Some indicators such as get_stock_shares_float, get_delisted_stocks, or the IPO disclosures/prospectuses receive only category-level mention, but the description is broadly sufficient.

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?

The schema already has 100% description coverage, so the baseline is 3, but the description adds cross-parameter guidance that the per-parameter schema cannot: it explains which parameters apply to which indicator, gives defaults (e.g. exchange='NASDAQ' for sector/industry metrics, primary_only defaults), and clarifies units such as min_market_cap in US dollars. Much of this overlaps with the schema, but the synthesis is useful.

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 enumeration of the resource families this tool retrieves (lists, screener, calendars, filings, news, sector/industry metrics), so an agent knows it is a market-discovery umbrella rather than an analytics tool. It does not explicitly name a sibling like 'performance' or 'valuation' as the alternative for analytical work, leaving the differentiation to be inferred from the listed content.

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 clear per-indicator usage context: news feeds cannot be narrowed to a ticker, calendars and filings take start_date/end_date, and the earnings calendar defaults to the coming week with optional min_market_cap/country/exchange filters. It also names an alternative path ('to screen by classification, use the Finance Database server'), but it does not explicitly compare this tool with sibling analytics tools.

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