Create a building permit alert
create_permit_alertCreates a recurring building permit alert. Requires name and filters, using the search_permits filter names (for example cities, workTypes, valueMin). cadence.frequency is daily, weekly, or monthly. Optional share block {mode, userIds, optOutUserIds}; sharing requires a paid plan. New matches arrive in the email digest. The same limits as planned-project alerts: filters must name a place (states, counties, or cities), with at most 5 states and 25 counties or cities, unless the plan is nationwide; and an account holds at most 25 active permit alerts (planned-project alerts are counted separately). permitIds, contractorKeys, placeKey, and bbox cannot be saved on an alert. A refusal names the rule (alert_geography_required, alert_geography_too_broad, or alert_limit_reached); relay it and offer to narrow the place or pause an alert. The alert follows the plan area. Writing the alert does not use credits. An alert created here is API-made, so its scheduled runs are charged: each new or changed permit a run adds counts as one export record, or 1 credit on API Only and the trial. Say so, with preview_permit_alert's count, before creating. This call does not send the digest. Confirm with the user first: the name, the place, the work types, and the value floor.
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": {
"name": "<name>",
"filters": "<filters>"
},
"name": "create_permit_alert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The alert's name, e.g. "Pool permits over $50k – Lehi". | |
| share | No | Team sharing. Any member of a shared alert may read, edit, run and delete it. Sharing requires a paid plan. | |
| active | No | false pauses the alert. | |
| cadence | No | How often new matches are emailed: daily, weekly, or monthly. | |
| filters | Yes | At least one filter, in the search_permits names, e.g. {"cities":["Lehi"],"workTypes":["pool"],"valueMin":50000}. | |
| findContactInfo | No | true runs Find Contact Info on each run's new permits, up to 200 a run: 1 credit per permit only when it adds an email, phone, or personal LinkedIn profile the permit did not print. Homeowners are never looked up. Confirm with the user before turning it on. |