About Pusher Channels
Pusher Channels is an MCP server connecting AI agents to Pusher Channels realtime messaging. It can trigger individual or batched events, inspect active channels and connected users, and create authorization tokens for private or presence channels.
Key features
- 01Send events to one or more channels
- 02Trigger events in batches
- 03List channels and retrieve channel details
- 04View users on presence channels
- 05Generate channel authorization tokens
- 06Terminate user connections
Use cases
- 01Send deployment events to a notification channel
- 02Inspect active presence channels
- 03Check channel subscriptions or connected users
- 04Disconnect all connections for a user
MCP support
The MCP server provides clients with tools for triggering Pusher Channels events, querying channels, managing users, and authorizing channels.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @crashbytes/pusher-mcp-serverPUSHER_APP_IDYour Pusher application IDPUSHER_KEYSecretYour Pusher application keyPUSHER_SECRETSecretYour Pusher application secretPUSHER_CLUSTERPusher cluster region (e.g. us2, eu, ap1)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
7Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| data | any | Yes | Event payload — string or JSON object (max 10KB) |
| event | string | Yes | Event name to trigger (e.g. 'new-message', 'update') |
| channel | any | Yes | Channel name or array of channel names (max 100) |
| socketId | string | No | Optional socket ID to exclude from receiving the event (prevents echo) |
Details
From the project READMEPusher 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.