Pusher MCP Server

🚀 Pusher Channels MCP Server

An MCP (Model Context Protocol) server that enables AI agents to send real-time messages, query channels, and manage users via Pusher Channels.

🚀 Quick Start

This server allows AI agents to interact with Pusher Channels, facilitating real - time communication and user management.

✨ Features

📦 Installation

Install via npm

npm install -g @crashbytes/pusher-mcp-server

Install from source

git clone https://github.com/CrashBytes/pusher-mcp-server.git
cd pusher-mcp-server
npm install
npm run build

📚 Documentation

Prerequisites

• Node.js 18 or later
• A Pusher Channels account (free tier available)

Configuration

You need four environment variables from your Pusher dashboard:

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