search_contractors
Fetch enriched contractor records for a state × trade × geo query. Charges the partner balance at price_per_record_cents × records_delivered. Set dry_run:true for a free cost preview. Returns structured shortfall info on insufficient balance so the agent can prompt the user to top up.
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": {
"state": "<state>",
"trade": "<trade>",
"geo_type": "<geo_type>",
"geo_value": "<geo_value>"
},
"name": "search_contractors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| state | Yes | ||
| trade | Yes | ||
| dry_run | No | ||
| geo_type | Yes | ||
| geo_value | Yes | ||
| active_only | No |