Screen companies by criteria
screen_companiesFilters the tracked companies on revenue growth, margins, price/sales, market cap, trend or segment, and sorts the result by one of these measures. Use it when the user asks which companies meet numeric criteria, for example revenue growth above 40% with a gross margin above 60%. A company whose filtered figure does not exist (not filed, or a ratio between two currencies) is listed separately in notComparable with the reason; it is not below the threshold.
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_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return (default 25, max 100). | |
| trend | No | Only companies in this trend: 'up' (price above its 50-day and 200-day averages, the 50-day above the 200-day), 'down' (the reverse), 'neutral' (neither; 'flat' is accepted for it). | |
| sortBy | No | Sort key (default marketCap). | |
| segment | No | Restrict to one or more segments, comma-separated, e.g. 'compute,memory,equipment'. Any of: compute, interconnect, optics, memory, systems, power, neocloud, equipment, software, platform, other. | |
| minMarketCap | No | Minimum market capitalisation, in dollars. | |
| minGrossMargin | No | Minimum gross margin of the latest quarter, as a fraction. | |
| maxPriceToSales | No | Maximum price / sales. | |
| minRevenueGrowth | No | Minimum revenue growth of the latest quarter against the same quarter a year earlier (a fiscal year for `basis` 'fiscal year'), as a fraction (0.4 = 40%). | |
| minOperatingMargin | No | Minimum operating margin of the latest quarter, as a fraction. | |
| minRevenueGrowthTtm | No | Minimum revenue growth over the trailing twelve months (the last four quarters against the four before; a fiscal year for `basis` 'fiscal year'), as a fraction. |