Screen Companies by Financials
screen_companiesScreen US public companies for one fiscal year by financial criteria and return the matches with their name, tickers, industry and metrics, largest revenue first. Use it to discover companies; use company_financials for one known company's history and industry_aggregate for cohort benchmarks. Cost: $0.10 per call; unpaid calls return a payment-required error.
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": {
"fy": "<fy>",
"filters": "<filters>"
},
"name": "screen_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fy | Yes | Fiscal year to screen, e.g. 2025. | |
| limit | No | Maximum companies to return, largest revenue first; up to 500. | |
| filters | Yes | JSON list of [metric, op, value] triples that must all hold, e.g. [["gross_margin",">",0.6],["revenue",">",1e9]]. op is >, >=, <, <= or =; value is a number; up to 8 triples (more are ignored). An unknown metric returns an error listing the valid ones. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |