List broadcasts
list_broadcastsUse this when the founder wants to see a project's email broadcasts, to pick up a draft they started, or to find one a follow-up should build on. They come newest first: drafts, scheduled, sending, sent. Each row has the bcd_… handle, name, status, subject, when it was scheduled or sent, and the headline results (recipients, delivered, bounced, unsubscribed). Filter by status (draft, scheduled, sending, sent, paused, canceled, failed) to narrow it. Not for one broadcast's content or recipients (use get_broadcast).
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": {
"project": "<project>"
},
"name": "list_broadcasts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many to return, 1-50. Defaults to 20. | |
| status | No | Only broadcasts in this status. | |
| project | Yes | The project handle, like `prj_…`. | |
| starting_after | No | A `bcd_…` handle from the previous page, to continue after it. |