Skip to main content
Glama

Broadcast Content

broadcast_content
Destructive

Sends HTML to many displays at once. Target explicit display_ids, all=true for every accessible display, or include_category_ids to reach every display in those categories (include_descendants for subcategories, dry_run to preview matches without sending). Locked displays are skipped with reasons. For a single display use send_html. Requires content scope.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
allNotrue targets all accessible displays.
htmlNoComplete HTML document. Mutually exclusive with base64_html.
dry_runNoPreview: return the matched displays without sending. Works with all targeting modes.
durationNoSeconds the content stays; 0 = indefinite.
base64_htmlNoBase64-encoded HTML. Mutually exclusive with html.
descriptionNoShort summary of the content being sent (required when sending).
display_idsNoDisplay profile IDs to target.
access_tokenNoOptional bearer token; prefer session_request_id.
session_request_idNoSession handle from create_auth_session; pass it on every authenticated call.
include_descendantsNoWith include_category_ids: also include subcategories.
include_category_idsNoCategory IDs: broadcast to displays assigned to these categories.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
sentNo
dryRunNo
matchedNo
resultsNo
skippedNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "dryRun": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "matched": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "results": {
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "sent": {
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "skipped": {
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed15 schema fields changed
    • changedInput schema / properties / access_token / description
      Previous value: -"Optional JWT access token for authentication."New value: +"Optional bearer token; prefer session_request_id."
    • changedInput schema / properties / all / description
      Previous value: -"Set to true to target all accessible displays."New value: +"true targets all accessible displays."
    • changedInput schema / properties / base64_html / description
      Previous value: -"Base64-encoded HTML string. Mutually exclusive with html."New value: +"Base64-encoded HTML. Mutually exclusive with html."
    • removedInput schema / properties / content_description
      Removed value: -{
      -  "description": "Optional semantic description of the content.",
      -  "type": "string"
      -}
    • changedInput schema / properties / description / description
      Previous value: -"Short description of the content being sent."New value: +"Short summary of the content being sent (required when sending)."
    • changedInput schema / properties / display_ids / description
      Previous value: -"Array of display profile IDs to target. Provide this or set all to true."New value: +"Display profile IDs to target."
    • addedInput schema / properties / dry_run
      Added value: +{
      +  "description": "Preview: return the matched displays without sending. Works with all targeting modes.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / duration / description
      Previous value: -"How long content stays in seconds. 0 = indefinite."New value: +"Seconds the content stays; 0 = indefinite."
    • addedInput schema / properties / duration / minimum
      Added value: +0
    • changedInput schema / properties / html / description
      Previous value: -"Complete HTML document to render. Mutually exclusive with base64_html."New value: +"Complete HTML document. Mutually exclusive with base64_html."
    • addedInput schema / properties / include_category_ids
      Added value: +{
      +  "description": "Category IDs: broadcast to displays assigned to these categories.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / include_descendants
      Added value: +{
      +  "description": "With include_category_ids: also include subcategories.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / session_request_id / description
      Previous value: -"Optional session request ID."New value: +"Session handle from create_auth_session; pass it on every authenticated call."
    • removedInput schema / required
      Removed value: -[
      -  "description"
      -]
    • changedOutput schema / (root)
      Previous value: -{
      -  "properties": {
      -    "duration": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "fileName": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "sent": {
      -      "items": {
      -        "properties": {
      -          "id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "array",
      -        "null"
      -      ]
      -    },
      -    "sentCount": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "skipped": {
      -      "items": {
      -        "properties": {
      -          "id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "reason": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "array",
      -        "null"
      -      ]
      -    },
      -    "skippedCount": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": "object"
      -}New value: +null
  3. Changed13 schema fields changed
    • changedOutput schema / properties / duration / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedOutput schema / properties / fileName / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / sent / items / properties / id / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / sent / items / properties / name / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / sent / items / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedOutput schema / properties / sent / type
      Previous value: -"array"New value: +[
      +  "array",
      +  "null"
      +]
    • changedOutput schema / properties / sentCount / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
    • changedOutput schema / properties / skipped / items / properties / id / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / skipped / items / properties / name / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / skipped / items / properties / reason / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / skipped / items / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedOutput schema / properties / skipped / type
      Previous value: -"array"New value: +[
      +  "array",
      +  "null"
      +]
    • changedOutput schema / properties / skippedCount / type
      Previous value: -"integer"New value: +[
      +  "integer",
      +  "null"
      +]
  4. Changed18 schema fields changed
    • removedInput schema / properties / access_token / default
      Removed value: -null
    • changedInput schema / properties / access_token / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • removedInput schema / properties / all / default
      Removed value: -null
    • changedInput schema / properties / all / type
      Previous value: -[
      -  "boolean",
      -  "null"
      -]New value: +"boolean"
    • removedInput schema / properties / base64_html / default
      Removed value: -null
    • changedInput schema / properties / base64_html / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • removedInput schema / properties / content_description / default
      Removed value: -null
    • changedInput schema / properties / content_description / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • removedInput schema / properties / display_ids / default
      Removed value: -null
    • changedInput schema / properties / display_ids / items / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • changedInput schema / properties / display_ids / type
      Previous value: -[
      -  "array",
      -  "null"
      -]New value: +"array"
    • removedInput schema / properties / duration / default
      Removed value: -null
    • changedInput schema / properties / duration / type
      Previous value: -[
      -  "integer",
      -  "null"
      -]New value: +"integer"
    • removedInput schema / properties / html / default
      Removed value: -null
    • changedInput schema / properties / html / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • removedInput schema / properties / session_request_id / default
      Removed value: -null
    • changedInput schema / properties / session_request_id / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "duration": {
      +      "type": "integer"
      +    },
      +    "fileName": {
      +      "type": "string"
      +    },
      +    "sent": {
      +      "items": {
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "sentCount": {
      +      "type": "integer"
      +    },
      +    "skipped": {
      +      "items": {
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "reason": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "skippedCount": {
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
  5. First observed

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already signal destructive mutation, read/write behavior, and non-idempotence. The description adds behavioral disclosures beyond the annotations: locked displays are skipped with reasons, all=true means 'every accessible display', and dry_run previews without sending. It also states the auth requirement 'Requires content scope'.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three compact sentences front-load the core purpose and then layer targeting, preview, and constraints. No filler or redundant restatement of the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 11-parameter broadcast tool with an output schema present, the description covers auth scope, targeting modes, locked-display failure behavior, and alternative routing. It stops short of stating explicit conflict rules between targeting parameters, but the 'or' phrasing and full schema coverage make the remaining ambiguity minor.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

While the schema covers 100% of parameters, the description adds grouping semantics: it identifies the three mutually exclusive targeting strategies ('explicit display_ids, all=true... or include_category_ids'), explains include_descendants as subcategory expansion, and positions dry_run as a preview option across all modes. This synthesis is value beyond the per-parameter schema text.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence 'Sends HTML to many displays at once' states a specific verb plus resource and scope. It distinguishes itself from send_html with 'For a single display use send_html', and names the three targeting modes. This leaves no ambiguity about what the tool is for.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly tells the agent when to prefer the sibling send_html ('For a single display') and when broadcast_content is appropriate (explicit display_ids, all=true, or include_category_ids). It also covers preview with dry_run and subcategory expansion with include_descendants, giving concrete selection context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4/5.0
Disambiguation4/5

Most tools map cleanly to distinct resource-action pairs (displays, organizations, assets, data slots, store templates, auth). A few clusters like the get_store_template_* family and the auth/session tools could still confuse an agent, but their descriptions are explicit enough to separate them.

Naming Consistency4/5

The dominant pattern is consistent verb_noun snake_case (list_*, get_*, create_*, delete_*, send_*, set_*, manage_*). Deviations like fetch, search, authenticate, logout, and pair_by_code are understandable but break the otherwise uniform naming scheme.

Tool Count1/5

With 57 tools this server far exceeds the 50+ threshold, creating an extreme tool-set size for an MCP server. Even though the underlying platform is feature-rich, the sheer number of tools heavily taxes context and selection.

Completeness4/5

The surface covers display, organization, asset, data slot, store template, auth, API key, and licensing lifecycles in impressive depth. Minor gaps exist, such as no delete operation for display categories and no reboot/power control for displays.

Resources