Search Entities
search_entitiesDiscover businesses using partial or fuzzy names. Search across jurisdictions to list matching companies when the exact entity is unknown.
Instructions
Discover candidate businesses when the exact entity is UNKNOWN — a listing/discovery tool, NOT a verification tool. Use only when the user wants to browse or list multiple companies matching a partial or fuzzy name, or does not yet know which specific entity they mean. If the user can name one specific company they want to confirm or check, use verify_business instead (ask them for the name first if needed). Costs 2 credits per jurisdiction searched and requires authentication.
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": {
"query": "<query>"
},
"name": "search_entities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return (1-200, default 50) | |
| query | Yes | Business name search query | |
| offset | No | Number of results to skip for pagination (default 0) | |
| entity_type | No | Filter by entity type | |
| jurisdiction | No | Jurisdiction code or name (omit to search all active) |