Pusher Channels MCP Server

An MCP (Model Context Protocol) server that gives AI agents the ability to send realtime messages, query channels, and manage users through Pusher Channels.

Tools

| Tool | Description | |------|-------------| | trigger_event | Send an event to one or more channels | | trigger_batch_events | Send up to 10 events in a single API call | | list_channels | List active channels with optional prefix filter | | get_channel_info | Get subscription/user count for a channel | | get_presence_users | List users connected to a presence channel | | authorize_channel | Generate auth tokens for private/presence channels | | terminate_user_connections | Disconnect all connections for a user |

Prerequisites

• Node.js 18 or later
• A Pusher Channels account (free tier available)

Installation

npm install -g @crashbytes/pusher-mcp-server

Or clone and build from source:

git clone https://github.com/CrashBytes/pusher-mcp-server.git
cd pusher-mcp-server
npm install
npm run build

Configuration

You need four environment variables from your Pusher dashboard:

| Variable | Description | |----------|-------------| | PUSHER_APP_ID | Your Pusher app ID | | PUSHER_KEY | Your Pusher app key | | PUSHER_SECRET | Your Pusher app secret | | PUSHER_CLUSTER | Your Pusher cluster (e.g. us2, eu, ap1) |

Usage with Claude Desktop

Add the following to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pusher": {
      "command": "node",
      "args": ["/path/to/pusher-mcp-server/build/index.js"],
      "env": {
        "PUSHER_APP_ID": "your_app_id",
        "PUSHER_KEY": "your_app_key",
        "PUSHER_SECRET": "your_app_secret",
        "PUSHER_CLUSTER": "us2"
      }
    }
  }
}

If installed globally via npm:

{
  "mcpServers": {
    "pusher": {
      "command": "pusher-mcp-server",
      "env": {
        "PUSHER_APP_ID": "your_app_id",
        "PUSHER_KEY": "your_app_key",
        "PUSHER_SECRET": "your_app_secret",
        "PUSHER_CLUSTER": "us2"
      }
    }
  }
}

Usage with Claude Code

claude mcp add pusher -- node /path/to/pusher-mcp-server/build/index.js

Set the environment variables in your shell before running, or configure them in your Claude Code MCP settings.

Example Prompts

Once configured, you can ask Claude things like:

• "Send a 'deploy-complete' event to the notifications channel with the message 'v2.1.0 deployed'"
• "Show me all active presence channels"
• "How many users are on the presence-lobby channel?"
• "Disconnect user abc123 from all channels"

Development

npm install
npm run dev          # Run with tsx (hot reload)
npm run build        # Compile TypeScript
npm run type-check   # Check types without emitting

Tutorial

For a step-by-step guide on building this server from scratch, see the full tutorial on CrashBytes.

License

MIT