Run an alert now
run_alertStarts an alert run now. It emails the digest to members and to any saved extra addresses, and POSTs a saved webhook. Those sends cannot be unsent. Does not use credits to start; the run charges when it delivers records. preview_alert returns the match count and credit quote for that run. get_alert_matches reads projects already on the alert. A repeat in the same window returns already_running and adds no charge. Manual runs are capped at 3 per America/Denver calendar day.
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": {
"alertId": "<alertId>"
},
"name": "run_alert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alertId | Yes | The planned-project alert's public id ("alr_…"), from list_alerts or create_alert. Permit alert ids ("palr_…") go to the permit alert tools. |