MCP tools — Broadcasts
Five tools to schedule, edit, inspect, and delete template broadcasts.
Broadcasts are template campaigns sent to many contacts at once. Use the dashboard for the full editor — these tools cover programmatic creation, monitoring, and clean-up.
| Tool | Annotation | Purpose |
|---|---|---|
list_broadcasts |
IsReadOnly, IsIdempotent |
Filter by status |
get_broadcast |
IsReadOnly, IsIdempotent |
Stats per broadcast |
create_broadcast |
IsDestructive(false) |
Schedule a new campaign |
update_broadcast |
IsDestructive(false), IsIdempotent |
Edit drafts/scheduled |
delete_broadcast |
IsDestructive |
Delete the broadcast and its associated messages |
list_broadcasts
List broadcast campaigns with delivery stats. Filter by status.
| Input | Type | Notes |
|---|---|---|
status |
string | draft, scheduled, sending, completed, failed |
page, per_page |
integer |
get_broadcast
Get detailed broadcast info with delivery stats.
| Input | Type |
|---|---|
id |
UUID |
Returns the broadcast plus the live counters (sent_count, delivered_count, read_count, failed_count, revenue).
create_broadcast
Create a broadcast campaign. Target audience by tags (comma-separated) or contact_ids. Optionally schedule for later.
| Input | Type | Notes |
|---|---|---|
name |
string | required |
template_id |
UUID | required, must be APPROVED |
language |
string | required, must have an approved translation |
variables |
object | required if the template has placeholders |
target_tags |
string | comma-separated tag names |
target_contact_ids |
UUID[] | explicit contact list |
target_segment_id |
UUID | use a saved segment instead of tags/ids |
scheduled_at |
ISO 8601 | omit to send immediately |
Pick exactly one target source. The broadcast is created in draft if no scheduled_at, or scheduled otherwise.
update_broadcast
Update a draft or scheduled broadcast. Cannot update broadcasts that are sending or completed.
Same fields as create_broadcast, all optional. Use it to retarget, reschedule, or change variables before send.
delete_broadcast
Delete a broadcast and its associated messages.
IsDestructive — clients prompt every time. Only safe to run on draft or failed broadcasts. A completed broadcast's messages live in the inbox; deleting them removes audit history.