MCP Server

The Broadcast MCP (Model Context Protocol) Server exposes your Broadcast instance as native Claude Code tools. Instead of running CLI commands, Claude Code can directly call Broadcast operations as tool functions.

What is MCP?

MCP is a protocol that allows AI assistants like Claude Code to interact with external services through structured tool definitions. Each tool has a name, description, and input schema — Claude Code understands what each tool does and when to use it.

Installation

Prerequisites

  • Node.js 18+ installed
  • A Broadcast API token with the permissions you need

Configure Claude Code

Add the Broadcast MCP server to your Claude Code configuration:

{
  "mcpServers": {
    "broadcast": {
      "command": "npx",
      "args": ["-y", "@broadcast/mcp-server"],
      "env": {
        "BROADCAST_HOST": "https://your-instance.com",
        "BROADCAST_TOKEN": "your-api-token"
      }
    }
  }
}

Note

If you’ve already configured the Broadcast CLI, the MCP server can auto-discover credentials from `~/.config/broadcast/config`. In that case, you can omit the `env` section.

Available Tools

Once configured, Claude Code gains access to these tools:

Discovery

Tool Description
broadcast_prime Get full capabilities manifest
broadcast_whoami Check token identity and permissions
broadcast_status Check channel health and readiness

Subscribers

Tool Description
broadcast_subscribers_list List subscribers with pagination
broadcast_subscribers_find Find a subscriber by email
broadcast_subscribers_create Create a new subscriber
broadcast_subscribers_tag Add a tag to a subscriber

Broadcasts

Tool Description
broadcast_broadcasts_list List broadcasts
broadcast_broadcasts_show Get broadcast details
broadcast_broadcasts_create Create a draft broadcast
broadcast_broadcasts_send Send a broadcast
broadcast_broadcasts_stats Get broadcast statistics

Sequences

Tool Description
broadcast_sequences_list List sequences
broadcast_sequences_show Get sequence details

Example Usage

After configuring the MCP server, you can interact with Broadcast naturally in Claude Code:

You: How many subscribers do I have?

Claude: Let me check your Broadcast status.
[Calls broadcast_status tool]
You have 4,800 active subscribers out of 5,000 total.

You: Create a newsletter about our product launch.

Claude: I'll create a draft broadcast for you.
[Calls broadcast_broadcasts_create tool]
Created draft broadcast #42: "Product Launch Announcement"
Would you like me to send it?

Troubleshooting

“Server not found” error

Make sure Node.js 18+ is installed:

node --version

“Unauthorized” response

Verify your API token is correct:

curl -H "Authorization: Bearer YOUR_TOKEN" https://your-instance.com/api/v1/whoami

Tools not appearing

Restart Claude Code after updating the MCP configuration. The server registers tools on startup.

Was this page helpful?

Thanks for your feedback!

Thanks for letting us know. We'll work on improving this page.