Skip to main content
Glama

list_broadcasts

Read-only

List broadcasts in the application with status, schedule, and delivery counts. Read-only. Filters combine as AND. Note that delivery counts report messages attempted, not confirmed deliveries. recipientCount is the number of delivery rows once the broadcast has started sending. Before that it is a live count of the audience only when the audience has no filter. null means NOT COMPUTED, never zero: a filtered audience is evaluated when the broadcast sends, and get_broadcast_details reads delivery rows only, so it is null for every broadcast that has none yet. Use get_broadcast_details for one broadcast's full breakdown. To CREATE or SEND a broadcast use apply_actions: create_broadcast makes a draft, update_broadcast (status SCHEDULED) schedules/sends it — see get_action_schema under broadcasts.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNo1-based page number. Defaults to 1.
botIdNoOnly broadcasts belonging to this bot. Omit for all bots in the application.
limitNoBroadcasts per page, between 1 and 100. Defaults to 10.
statusNoOnly broadcasts in this lifecycle state (FAILED = the send broke and did not finish). Omit for all states.
isRecurringNoTrue for recurring broadcasts only, false for one-off only. Omit for both.
applicationIdNoApplication (workspace) id. Optional: an application-scoped key (app_...) defaults to its own application, but a personal key (usr_...) has no default and omitting it fails with MCP_APPLICATION_REQUIRED. Call list_applications to get the id.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"Broadcasts per page, between 1 and 100."New value: +"Broadcasts per page, between 1 and 100. Defaults to 10."
    • changedInput schema / properties / status / description
      Previous value: -"Only broadcasts in this lifecycle state. Omit for all states."New value: +"Only broadcasts in this lifecycle state (FAILED = the send broke and did not finish). Omit for all states."
    • changedInput schema / properties / status / enum
      Previous value: -[
      -  "DRAFT",
      -  "SCHEDULED",
      -  "QUEUED",
      -  "SENDING",
      -  "SENT",
      -  "PAUSED",
      -  "CANCELLED"
      -]New value: +[
      +  "DRAFT",
      +  "SCHEDULED",
      +  "QUEUED",
      +  "SENDING",
      +  "SENT",
      +  "PAUSED",
      +  "CANCELLED",
      +  "FAILED"
      +]
  2. Changed6 schema fields changed
    • addedInput schema / properties / applicationId / description
      Added value: +"Application (workspace) id. Optional: an application-scoped key (app_...) defaults to its own application, but a personal key (usr_...) has no default and omitting it fails with MCP_APPLICATION_REQUIRED. Call list_applications to get the id."
    • addedInput schema / properties / botId / description
      Added value: +"Only broadcasts belonging to this bot. Omit for all bots in the application."
    • addedInput schema / properties / isRecurring / description
      Added value: +"True for recurring broadcasts only, false for one-off only. Omit for both."
    • addedInput schema / properties / limit / description
      Added value: +"Broadcasts per page, between 1 and 100."
    • addedInput schema / properties / page / description
      Added value: +"1-based page number. Defaults to 1."
    • addedInput schema / properties / status / description
      Added value: +"Only broadcasts in this lifecycle state. Omit for all states."
  3. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.