Back to Browse

Pusher MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Trigger events, query channels, and manage realtime messaging on Pusher Channels.

About

Trigger events, query channels, and manage realtime messaging on Pusher Channels.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (10 strong, 10 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

12 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Pusher application IDOptional

Environment variable: PUSHER_APP_ID

Your Pusher application keyOptional

Environment variable: PUSHER_KEY

Your Pusher application secretRequired

Environment variable: PUSHER_SECRET

Pusher cluster region (e.g. us2, eu, ap1)Optional

Environment variable: PUSHER_CLUSTER

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-crashbytes-pusher-mcp-server": {
      "env": {
        "PUSHER_KEY": "your-pusher-key-here",
        "PUSHER_APP_ID": "your-pusher-app-id-here",
        "PUSHER_SECRET": "your-pusher-secret-here",
        "PUSHER_CLUSTER": "your-pusher-cluster-here"
      },
      "args": [
        "-y",
        "@crashbytes/pusher-mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

ToolDescription
trigger_eventSend an event to one or more channels
trigger_batch_eventsSend up to 10 events in a single API call
list_channelsList active channels with optional prefix filter
get_channel_infoGet subscription/user count for a channel
get_presence_usersList users connected to a presence channel
authorize_channelGenerate auth tokens for private/presence channels
terminate_user_connectionsDisconnect all connections for a user

Prerequisites

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:

VariableDescription
PUSHER_APP_IDYour Pusher app ID
PUSHER_KEYYour Pusher app key
PUSHER_SECRETYour Pusher app secret
PUSHER_CLUSTERYour 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

Reviews

No reviews yet

Be the first to review this server!