Find local businesses
find_businessesSearch the VoiceAssistants directory of local US businesses by what the person needs (a trade such as "plumber", a service such as "drain cleaning", or a business name) and where (city and two-letter state). Optional filters: open right now, available today, or a maximum starting price in US dollars. Returns up to limit businesses, each with an id to pass to get_business, get_hours or answer_question. If nothing matches exactly, the search is widened and relaxed says how. Results are ordered by how recently each business was verified, never by payment. Read spoken aloud as the answer.
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": "find_businesses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name, for example "Stuart". | |
| limit | No | How many to return. Default 5. | |
| query | No | What is needed: a trade ("plumber"), a service ("AC repair") or a business name. Plain words. | |
| state | No | Two-letter US state code, for example "FL". | |
| open_now | No | Only businesses open at this moment in their own time zone. | |
| available_today | No | Only businesses that have confirmed today that they can take new work today. | |
| max_starting_price | No | Only businesses with a published starting price at or below this many US dollars. |