Pusher

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