Search permit cases
search_permitsSearch and filter pending excavation permits by street, city, applicant, project type, verdict, or risk level. Get summaries to triage risks; retrieve full details with get_permit.
Instructions
Search and filter pending excavation permit cases. Use this to find permits by street, city, applicant, project type, permit verdict, or risk level. Returns a summary of each match, not the full utility line detail — call get_permit for that.
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": "search_permits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Exact city filter, e.g. 'Bellflower, CA'. | |
| limit | No | Maximum results to return. Default 10. | |
| query | No | Free text matched against street name, city, scope, applicant, and permit ID. | |
| verdict | No | Filter by the permit's current verdict. | |
| min_risk | No | Only permits at or above this crossing-risk band. | |
| only_flagged | No | Only permits with at least one line flagged for field verification. | |
| project_type | No | High-level project category. | |
| contains_utility_type | No | Only permits with at least one line of this utility type near the excavation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| permits | Yes | ||
| matchCount | Yes | ||
| totalPermits | Yes | ||
| filtersApplied | No |