Pusher Channels
Trigger events, query channels, and manage realtime messaging on Pusher Channels.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@crashbytes/pusher-mcp-serverclaude mcp add pusher-channels -e 'PUSHER_APP_ID=<PUSHER_APP_ID>' -e 'PUSHER_KEY=<PUSHER_KEY>' -e 'PUSHER_SECRET=<your pusher_secret>' -e 'PUSHER_CLUSTER=<PUSHER_CLUSTER>' -- npx -y @crashbytes/pusher-mcp-server@1.0.3
{
"mcpServers": {
"pusher-channels": {
"command": "npx",
"args": [
"-y",
"@crashbytes/pusher-mcp-server@1.0.3"
],
"env": {
"PUSHER_APP_ID": "<PUSHER_APP_ID>",
"PUSHER_KEY": "<PUSHER_KEY>",
"PUSHER_SECRET": "<your pusher_secret>",
"PUSHER_CLUSTER": "<PUSHER_CLUSTER>"
}
}
}
}
Environment variables
PUSHER_APP_IDrequired Your Pusher application IDPUSHER_KEYrequired Your Pusher application keyPUSHER_SECRETrequired secret Your Pusher application secretPUSHER_CLUSTERrequired Pusher cluster region (e.g. us2, eu, ap1)
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
Frequently asked questions
What is Pusher Channels?
Trigger events, query channels, and manage realtime messaging on Pusher Channels.
How do I install Pusher Channels?
It runs on your machine. In Claude Code: claude mcp add pusher-channels -e 'PUSHER_APP_ID=<PUSHER_APP_ID>' -e 'PUSHER_KEY=<PUSHER_KEY>' -e 'PUSHER_SECRET=<your pusher_secret>' -e 'PUSHER_CLUSTER=<PUSHER_CLUSTER>' -- npx -y @crashbytes/pusher-mcp-server@1.0.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Pusher Channels need an API key?
Yes. It expects PUSHER_APP_ID, PUSHER_KEY, PUSHER_SECRET, PUSHER_CLUSTER, which you set in its configuration.
Is Pusher Channels open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Pusher Channels?
It is published by CrashBytes. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.