pubnub/pubnub-mcp-server

A hosted Model Context Protocol (MCP) server that exposes PubNub SDK documentation and PubNub API resources to LLM-powered tools. This improves the LLM AI Agent's ability to understand and interact with PubNub's SDKs and APIs. Uses HTTP transport with OAuth authentication.
Features
- **📚 Comprehensive SDK Documentation** - Access detailed documentation, code examples, and implementation guides for 20+ programming languages including JavaScript, Python, Java, Swift, Kotlin, C#, Ruby, Go, and more
- **🏗️ Application & Keyset Management** - Create, configure, and manage PubNub applications and keysets with features like message persistence, file sharing, presence tracking, and app context
- **💬 Real-time Communication** - Send and receive messages across channels, implement live chat, notifications, and real-time updates with support for both messages and lightweight signals
- **👥 User & Channel Management** - Manage user profiles, channel metadata, and membership relationships with full CRUD operations for building community and social features. In addition, there is an option to view & manage user profiles, channels and memberships in PubNub Admin Portal (this requires Manage Premium).
- **📍 Presence & Activity Tracking** - Monitor real-time user presence, see who's online in channels, and track user activity across your application
- **📊 Real-time Decisioning & Analytics** - Trigger the right action when it matters, measure its impact, and adjust as conditions change -- all in real-time. Requires Illuminate.
- **📈 Channel, User & Message Analytics** - Spot patterns in aggregated app activity, from top channels and country breakdowns to new vs. recurring users and device distribution, to understand engagement, usage, and performance. In addition, limited metrics are available for viewing in PubNub Admin Portal without Manage Premium; full analytics require Manage Premium.
- **🔍 Usage & Monitoring** — Track billable usage across apps and keysets, review current and historical consumption, and export reports to understand cost drivers.
- **🔧 Multi-Platform Integration** - Works with Cursor, Visual Studio Code, Claude Code, and other MCP-compatible AI assistants
- **⚡ Developer Experience** - Built with TypeScript for type safety, includes testing infrastructure
Quick Start
The hosted server is managed by PubNub and provides the easiest way to get started — no installation required, and authentication is handled automatically via OAuth. If your AI tool doesn't support remote MCP servers, use the locally installed version (npx @pubnub/mcp@latest) instead.
> **Note:** To switch to the hosted server (https://mcp.pubnub.com), remove the old local configuration from your AI client first, then follow the setup steps below.
Hosted PubNub MCP Server
Connect your AI assistant to https://mcp.pubnub.com — no installation required. Authentication is handled automatically via OAuth.
VS Code
Click the button above, then select **Open in Visual Studio Code**. Back in VS Code, click **Install**, then select the organization you want to authorize and click **Allow access**.
Alternatively, add the following to your VS Code settings.json manually:
Learn more in VS Code documentation
Cursor
Click the button above, then select **Open Cursor**. In Cursor, click **Install**, select the organization you want to authorize, and click **Allow access**. Navigate to Cursor Settings → **Tools & MCP** to verify PubNub is enabled.
Alternatively, add the following to .cursor/mcp.json (or ~/.cursor/mcp.json for global configuration) manually:
When you save the file, a notification is displayed. Click **Enable** to activate the MCP server. Learn more in Cursor documentation
Claude Code
In the terminal, run:
Then run claude to open Claude Code and enter /mcp. Select **pubnub**, then **authenticate**, and click **Allow access** to complete authorization. Learn more in Claude Code documentation
Claude Desktop
> **Note:** The following instructions apply to **Pro** and **Max** plans. For **Enterprise** plans, the setup is configured by your organization administrator. Refer to Anthropic's documentation for details.