home / mcp / pusher channels mcp server

Pusher Channels MCP Server

Provides real-time messaging, channel querying, and user management APIs for Pusher Channels via MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "crashbytes-pusher-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/pusher-mcp-server/build/index.js"
      ],
      "env": {
        "PUSHER_KEY": "YOUR_KEY",
        "PUSHER_APP_ID": "YOUR_APP_ID",
        "PUSHER_SECRET": "YOUR_SECRET",
        "PUSHER_CLUSTER": "YOUR_CLUSTER"
      }
    }
  }
}

You can use the Pusher Channels MCP Server to enable AI agents to send real-time messages, query channels, and manage users through Pusher Channels. This server provides practical MCP endpoints to drive live communications, presence information, and channel access control for your applications.

How to use

You will run the MCP server locally or remotely and connect your MCP client to it. The server exposes a set of endpoints that let you trigger events on channels, query channel details, manage presence information, authorize private/presence channels, and disconnect users as needed. Use these capabilities to build responsive AI-assisted workflows that rely on real-time messaging.

How to install

Prerequisites: Ensure you have Node.js 18 or later and a Pusher Channels account (free tier is available). Install the MCP server globally or run it from source.

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

Additional sections

Configuration and usage details are provided in the environment setup and runtime examples that follow. You will supply four environment variables from your Pusher dashboard to authenticate and route requests.

If you install the server locally, you can run it with Node.js by pointing to the built entry point and passing your Pusher credentials as environment variables.

If you install the server globally via npm, you can start it directly using the global binary and the same environment variables.

Available tools

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