Skip to main content
Glama
Pusher Channels MCP Server

Pusher Channels MCP Server

by CrashBytes

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

Related MCP server: agent-comm

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:

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

Available Tools

7 tools
authorize_channelA

Generate an authorization token for a private or presence channel. Useful when building auth endpoints for Pusher client connections.

Inputs: channel (required), socketId (required), presenceData.

get_channel_infoA

Get detailed information about a specific Pusher channel, including whether it is occupied and optional subscription/user counts.

Inputs: channel (required), info.

get_presence_usersA

List all users currently connected to a presence channel. Only works with channels that start with 'presence-'.

Inputs: channel (required).

list_channelsA

List all active channels in your Pusher app. Optionally filter by prefix (e.g. 'presence-' or 'private-') and request subscription or user counts.

Inputs: info, prefix.

terminate_user_connectionsA

Disconnect all connections for a specific user. Useful for moderation or security — forces a user offline across all channels.

Inputs: userId (required).

trigger_batch_eventsA

Send up to 10 events in a single API call. More efficient than triggering events individually when you need to notify multiple channels.

Inputs: events (required).

trigger_eventA

Send an event to one or more Pusher channels. Use this to push realtime messages to connected clients.

Inputs: data (required), event (required), channel (required), socketId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct resource+action: getting one channel's info, listing all channels, listing presence users, authorizing, triggering single vs batch events, and terminating users. The only mild adjacency is get_channel_info vs list_channels, but descriptions make the single-vs-collection boundary explicit.

    Naming Consistency5/5

    All 7 tools follow a consistent snake_case verb_noun pattern (get_, list_, authorize_, terminate_, trigger_). No mixing of conventions or vague verbs.

    Tool Count5/5

    7 tools is well-scoped for the Pusher Channels HTTP API surface, with no redundant or filler tools. Each maps to a meaningful capability agents need.

    Completeness4/5

    Covers the core lifecycle: channel info, channel listing, presence users, auth, event triggering (single and batch), and user termination. Minor gaps exist (e.g. webhook/signature handling or per-channel event queries), but core realtime workflows are fully covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      MCP server that integrates the LINE Messaging API to enable AI agents to send messages and manage LINE Official Accounts.
      12
      2,059 npm
      807
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that enables AI coding agents to communicate, share state, and coordinate work in real time via MCP tools or REST API.
      79 npm
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A standalone MCP server providing AI agents with full access to the Pumble messaging platform via OAuth2 and the Pumble SDK, including messaging, files, channels, search, scheduling, and real-time events.
      MIT