Fundamentals Screen (cross-sectional XBRL screen — revenue/margin/growth/cash-flow filters)
screen_fundamentalsCross-sectional screen over XBRL fundamentals: 'which companies have X financial profile', not 'show me company X's history' (that's get_fundamentals). Defaults to each company's LATEST quarter within the given scope, then applies every filter to that one quarter — a company whose latest quarter doesn't qualify is excluded even if an earlier quarter would have.
Numeric filters take _min/_max suffixes (e.g. revenue_min=1e9, operating_margin_min=0.15). Boolean filters (revenue_growing, margin_expanding, earnings_positive, cash_generation_positive, diluting, deleveraging) restrict to true when set.
us_only=true excludes Foreign Private Issuers (20-F) and Canadian MJDS filers (40-F) via form_type — no state-of-incorporation lookup needed, form_type is the SEC's own structural distinction.
Revenue filtering/sorting always applies a non-configurable revenue < $1T sanity guard — some non-USD filers (e.g. Telkom Indonesia, Ecopetrol) have nominal nine-figure-trillion nonsense in USD terms purely from unconverted foreign-currency reporting; reporting_currency is returned per row so you can see which currency a number is actually in.
view='full' returns every fundamentals_cooked column; default 'compact' returns identity + the standard margin/growth/flag set. fields adds specific extra columns (ignored if unknown). Every row carries accession_number (the 10-Q/10-K the quarter comes from) and filing_url.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "screen_fundamentals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sic | No | ||
| ciks | No | ||
| view | No | compact | |
| limit | No | Default 25, max 200. | |
| fields | No | Extra columns beyond the compact/full default, e.g. ['total_assets','cash']. | |
| sic_max | No | ||
| sic_min | No | ||
| sort_by | No | revenue | |
| tickers | No | ||
| us_only | No | Exclude 20-F/40-F foreign filers. | |
| diluting | No | ||
| sort_dir | No | desc | |
| end_date_to | No | YYYY-MM-DD, inclusive upper bound. Default: no bound (latest available). | |
| revenue_max | No | ||
| revenue_min | No | ||
| accruals_max | No | ||
| accruals_min | No | ||
| deleveraging | No | ||
| end_date_from | No | YYYY-MM-DD, inclusive lower bound on the qualifying quarter's end_date. | |
| fiscal_period | No | Restrict the 'latest quarter' selection to this fiscal_period (e.g. 'Q4', 'FY'). | |
| fcf_margin_max | No | ||
| fcf_margin_min | No | ||
| net_margin_max | No | ||
| net_margin_min | No | ||
| cash_runway_max | No | cash_runway_quarters — low values flag cash-burn risk. | |
| cash_runway_min | No | ||
| revenue_growing | No | ||
| revenue_yoy_max | No | ||
| revenue_yoy_min | No | ||
| margin_expanding | No | ||
| earnings_positive | No | ||
| operating_margin_max | No | ||
| operating_margin_min | No | ||
| cash_generation_positive | No |