Screen Companies
screen_companiesScreen companies by price range, volume, cash runway, float, shares outstanding, market cap, industry, listing exchange (NASDAQ/NYSE/AMEX), listing market (market="otc" / "exchange"; the reliable OTC test, as the exchange label is inconsistent on OTC rows), float data source, TTM dividend yield and snapshot cash (minCash / maxCash). Sortable by any sortable column. Returns matching companies with key metrics and pagination. Float: "float" is the measured point float (null on a withheld dilution-snapshot row, which then carries "floatEstimate" + "floatEstimateBound" ("point" / "ceiling" / "floor") + "floatEstimateBasis"). A point estimate is a number with its basis as the caveat; a ceiling or floor is a bound, not a figure: the float is not stated and is at most (ceiling) or at least (floor) that number. floatEstimate is not a basis for a market cap, percent-of-float or short-interest ratio. minFloat / maxFloat and the computed_float sort use the figure's value, so a bounded row is kept; a row with neither is not measured, not 0. shares_outstanding is dated by sharesOutstandingAsOf + sharesOutstandingAsOfKind (stated / checked / none = date not recorded) and sharesOutstandingSource; the count is only meaningful with its date. Cash runway: a null cash_runway_months carries cashRunwayReason. "estimate_would_be_negative" = the last cash figure (dated cashRunwayAsOf) rolled forward by burn is below zero: estimated exhausted, not a reported zero balance; maxCashRunway drops such rows unless includeRunwayExhausted=true. Any other or null reason is not a runway claim. estimatedCurrentCash (estimatedCashAsOf) is the snapshot's USD cash projection, only for snapshot-covered companies: null = not measured, not "no cash"; a non-USD filer has it null and is never matched by minCash / maxCash. dividendYield (TTM cash dividends with an ex-date in the last 365 days / current price, %), nextExDate, lastExDate: null = not measured or not a payer, not 0%. listingMarket: "exchange" / "otc", null = unknown. Each row carries live trading-halt status (halted/haltCode/haltedAt; false/null when trading normally); excludeHalted=true drops currently-halted tickers.
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 | Maximum results per page (default: 25, max: 100) | |
| market | No | Listing market: "otc" (OTC Markets) or "exchange" (NASDAQ / NYSE / NYSE American / Arca / Cboe). Companies with no listing record match neither | |
| offset | No | Offset for pagination (default: 0) | |
| sortBy | No | Column to sort results by (default: volume) | |
| country | No | Company universe by issuer domicile: "US" (default), "CA" (Canadian companies via their US-OTC/US cross-listings), or "all" | |
| maxCash | No | Maximum dilution-snapshot cash projection in USD (estimatedCurrentCash). Snapshot-covered companies only; an uncovered company is not measured, not excluded for having cash | |
| minCash | No | Minimum dilution-snapshot cash projection in USD (estimatedCurrentCash). Snapshot-covered companies reporting in USD only | |
| exchange | No | Filter by listing exchange: NASDAQ (every tier), NYSE (includes NYSE Arca), or AMEX (NYSE American). Each matches every spelling of that exchange; names that moved to OTC never match. For OTC use market="otc" instead | |
| industry | No | Filter by company industry (exact match, e.g. "Biotechnology", "Software") | |
| maxFloat | No | Maximum computed public float (shares) | |
| maxPrice | No | Maximum latest price in USD | |
| minFloat | No | Minimum computed public float (shares) | |
| minPrice | No | Minimum latest price in USD | |
| maxVolume | No | Maximum daily trading volume | |
| minVolume | No | Minimum daily trading volume | |
| sortOrder | No | Sort direction (default: desc) | |
| floatSource | No | Filter by float data source | |
| excludeHalted | No | When true, exclude tickers with a currently-active trading halt (regulatory or volatility) from the results. Default false: halted rows are included and carry halted/haltCode/haltedAt fields. | |
| maxCashRunway | No | Maximum estimated months of cash remaining | |
| minCashRunway | No | Minimum estimated months of cash remaining | |
| maxDividendYield | No | Maximum TTM dividend yield in percent. Rows with no measured yield never match. | |
| minDividendYield | No | Minimum TTM dividend yield in percent (e.g. 3 for 3%). Rows with no measured yield never match. | |
| maxMarketCapComputed | No | Maximum market cap in USD (price * shares outstanding) | |
| maxSharesOutstanding | No | Maximum shares outstanding from SEC EDGAR | |
| minMarketCapComputed | No | Minimum market cap in USD (price * shares outstanding) | |
| minSharesOutstanding | No | Minimum shares outstanding from SEC EDGAR | |
| includeRunwayExhausted | No | When true, maxCashRunway also returns companies whose estimated cash is already exhausted (cash_runway_months null, cashRunwayReason "estimate_would_be_negative"); they sort first on an ascending runway sort. Default false |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No |