Screen stocks
screen_stocksUse to find companies that meet conditions (cheap, high dividend, fast growth…). Filter and rank the covered universe (about 4,000 US-listed names) on fundamental fields (marketCap, peRatio, dividendYield, consecutiveYears, margins, 5y CAGRs, …). Returns at most 25 rows — the MCP tier's cap; the full screener lives at https://tgmcharts.com/screener. Units: yields, margins, growth and CAGRs are fractions, not percents (dividendYield gt 0.03 = above 3%; see the field description). Example: filters [{field: "dividendYield", operator: "gt", value: 0.03}, {field: "consecutiveYears", operator: "gte", value: 25}], sortBy "dividendYield".
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_stocks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return (default 10, max 25) | |
| format | No | json (default): the full JSON as text. markdown: a compact table or list, fewer tokens. structuredContent is the full JSON either way. | |
| sortBy | No | Sort field (default marketCap) | |
| filters | No | ||
| sortOrder | No | Default desc | |
| includeEtfs | No | Include ETFs (default false) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shown | Yes | ||
| stocks | Yes | ||
| screenerUrl | Yes | ||
| totalMatches | Yes |