Count records
count_recordsHow many records a search matches, and how they break down, with no rows read: the answer to every "how many". Say what to count (of: companies, deals, buyers, offerings, placement_agents, people) and give that kind's own search filters in where, by the same names its search takes, lists included. A count of companies says how many have a phone, an e-mail, both, neither, a named person's own line and a named owner or officer; by breaks a total down (companies by naics or state; deals by sector, deal_type or year; offerings by industry, state, sales_pay, fund_type, month or phone). One call a question. Never page through a search to count it, and never start subagents to count.
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": {
"of": "<of>"
},
"name": "count_records"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | Break the total down by these. companies: naics (each code searched), state. deals: sector, deal_type, year. offerings: industry, state, sales_pay, fund_type, month, phone. A count of companies always says how many have a phone, an e-mail, both, neither, a named person's own line and a named owner or officer; a count of people, how many have an e-mail, a phone or both; so contact coverage needs no `by`. | |
| of | Yes | What to count. companies: companies as find_companies finds them. deals: deals as search_deals finds them. buyers: the buyers find_buyers would list. offerings: Form D offerings as find_offerings finds them. placement_agents: the firms find_placement_agents would list. people: people as search_people finds them. | |
| where | No | The filters, by the same names that kind's own search takes (find_companies, search_deals, find_buyers, find_offerings, find_placement_agents, search_people), lists included: {"naics": ["237130", "238910"], "state": ["TX", "LA"], "min_staff": 30}. page, limit, sort and include_contacts are not filters and are ignored. |