Log inSubmit server
Pubnub MCP Server logo

Pubnub MCP Server

by pubnub

Connects AI assistants to PubNub documentation, messaging, administration, analytics, and usage tools over MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Pubnub MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-server-152": {
      "command": "npx",
      "args": [
        "-y",
        "@pubnub/mcp@latest"
      ],
      "env": {
        "PUBNUB_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

pubnub/pubnub-mcp-server MCP server gives AI assistants access to PubNub SDK documentation and API resources through hosted HTTP transport with OAuth authentication. Its tools cover documentation lookup, app and keyset administration, real-time messaging, presence, usage metrics, app context, Illuminate, and insights. Use it when an agent needs to build or operate PubNub applications, understand SDKs, or inspect PubNub activity. A local package is also available through npx for clients that cannot connect to remote MCP servers.

Use cases

  • Research PubNub SDK implementation patterns
  • Create and configure PubNub applications and keysets
  • Send and receive real-time PubNub messages
  • Inspect presence, usage, and application activity
  • Plan migrations between PubNub SDKs or configurations

Key features

  • SDK documentation and code guidance
  • Application and keyset management
  • Real-time message sending and subscription
  • Message history and presence lookup
  • Usage metrics and insights
  • App Context and Illuminate operations

Tools16

What Pubnub MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~75 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @pubnub/mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars33Stargazers on the source repository.
npm downloads1.8kPackage downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Tools exposed16Callable tools this server registers over MCP.

How Pubnub MCP Server works

What pubnub/pubnub-mcp-server MCP server does

pubnub/pubnub-mcp-server MCP server connects AI assistants with PubNub SDK guidance and PubNub API resources. It can provide implementation documentation, code examples, migration guidance, and how-to instructions for more than 20 programming languages, including JavaScript, Python, Java, Swift, Kotlin, C#, Ruby, and Go.

The server also exposes operations for PubNub administration and real-time application work. Agents can manage applications and keysets, send messages, subscribe to receive messages, retrieve message history, inspect presence, and work with app context. Additional tools cover usage metrics, Illuminate, and insights for monitoring or analyzing PubNub activity.

How it works

The hosted deployment is available at https://mcp.pubnub.com and uses HTTP transport with OAuth authentication. An MCP-compatible client connects to that URL, then the user authorizes access to a PubNub organization. The repository documents setup for VS Code, Cursor, Claude Code, Claude Desktop, Codex, and Gemini CLI.

For clients without remote MCP support, the package can run locally with npx @pubnub/mcp@latest. The local setup uses Node.js 20 or newer. A PubNub API key is recommended because some local features work without one, while additional functionality becomes available when the key is supplied.

Setup and configuration

For hosted use, configure the client with the server URL and complete the OAuth flow. No local installation is required. Client-specific setup may involve adding a remote server entry, using an MCP command, or adding a custom connector.

For local use, start the package with:

Terminal
npx @pubnub/mcp@latest

The documented local configuration uses the PUBNUB_API_KEY environment variable for a PubNub service integration or API key. The README also refers to an alternative configuration for working with a single PubNub keyset, but the supplied setup details do not specify its variable names.

Tools and capabilities

The listed MCP tools include:

  • get_sdk_documentation, get_chat_sdk_documentation, how_to, and write_pubnub_app for SDK research and application guidance.
  • get_sdk_migration_guide and get_general_migration_guide for migration-related information.
  • manage_apps and manage_keysets for PubNub application and keyset administration.
  • send_pubnub_message, subscribe_and_receive_pubnub_messages, and get_pubnub_messages for channel messaging workflows.
  • get_pubnub_presence for presence information.
  • manage_app_context for user, channel, and membership-related data.
  • manage_illuminate and insights for real-time decisioning and analytics-related operations.
  • get_usage_metrics for current or historical usage information.

Limitations and notes

pubnub/pubnub-mcp-server MCP server depends on PubNub access and authorization for operations that interact with accounts, applications, keysets, or data. Some local functionality is available without an API key, but the README recommends supplying one to unlock more features. User, channel, and membership administration through the PubNub Admin Portal requires Manage Premium. Full analytics require Manage Premium, while limited metrics are available without it; Illuminate is required for the real-time decisioning and analytics capabilities described in the README.

The hosted deployment requires an MCP client that supports remote HTTP connections and OAuth. If a client cannot use remote MCP servers, use the local npx package instead. The documented local installation requires Node.js 20.0 or later.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pubnub MCP Server

pubnub/pubnub-mcp-server is an MCP server that connects AI assistants to PubNub's hosted APIs and SDK documentation. Its main tools cover documentation lookup, app and keyset management, messaging, subscriptions, message retrieval, presence, usage metrics, app context, Illuminate, and insights. It supports hosted HTTP access with OAuth and local execution through npx.

Install the local server by running `npx @pubnub/mcp@latest` with Node.js 20 or newer. For hosted use, connect an MCP client to `https://mcp.pubnub.com` instead; no installation is required, and authentication uses OAuth.

Yes, it works with Cursor. Add the hosted URL to `.cursor/mcp.json` or use the documented installation link, then enable the server in Cursor Settings under Tools & MCP. Cursor can also be configured to run the local npx package.

Authenticate the hosted server through its OAuth login flow after connecting to `https://mcp.pubnub.com`. For local execution, provide a PubNub API key through `PUBNUB_API_KEY`; the README recommends creating a PubNub service integration for this purpose.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPubnub MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-server-152?style=directory)](https://allmcps.com/mcp/mcp-server-152)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-server-152"><img src="https://allmcps.com/api/badge/mcp-server-152?style=directory" alt="Pubnub MCP Server on AllMCPs" /></a>