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
• 📍 Presence & Activity Tracking - Monitor real-time user presence, see who's online in channels, and track user activity across your application
• 📊 Illuminate Analytics & Automation - Configure Illuminate business objects, queries, metrics, decisions, and dashboards to build real-time analytics pipelines and event-driven automation
• 📈 PubNub Insights Analytics - Query 23 aggregated analytics metrics across channels, users, messages, user behavior, and devices — including top-N rankings, country breakdowns, new vs. recurring user trends, and device type distributions. Requires Insights Premium tier.
• 🔧 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

For step-by-step setup instructions for your AI assistant (VS Code, Cursor, Claude Code, Claude Desktop, Codex, Gemini CLI, and more), refer to the Setup section in the PubNub documentation.

Development

Prerequisites

• Node.js >= 20.0.0

Running locally

npm install
npm run dev

Environment variables

Testing

npm run test:unit        # Unit tests
npm run test:integration # Integration tests (requires build)
npm run test:coverage    # Coverage report

API Reference

This PubNub MCP server provides a comprehensive set of tools, resources, and prompts to help you build real-time applications. Below is a complete reference of all available functionality:

Tools

Documentation Access

• **get_sdk_documentation** - Get PubNub Core SDK documentation for specific programming languages and features
• **get_chat_sdk_documentation** - Get PubNub Chat SDK documentation for specific programming languages and features
• **how_to** - Get PubNub conceptual guides for specific use cases and integrations
• **write_pubnub_app** - Get PubNub best practices guide covering architecture, security, channel modeling, and optimization
• **get_sdk_migration_guide** - Get SDK version migration guides
• **get_general_migration_guide** - Get general platform migration guides

App & Keyset Management

• **manage_apps** - Manage PubNub apps (list, create, update)
• **manage_keysets** - Manage PubNub keysets (get, list, create, update)
• **get_usage_metrics** - Fetch usage metrics for an account, app, or keyset

Real-time Communication

• **send_pubnub_message** - Send messages or lightweight signals to PubNub channels in real-time
• **subscribe_and_receive_pubnub_messages** - Subscribe to channels and receive real-time messages with configurable timeout and message limits
• **get_pubnub_messages** - Fetch historical messages from one or more PubNub channels
• **get_pubnub_presence** - Get presence data using HereNow (channel occupancy) or WhereNow (user's channels)
• **manage_app_context** - Manage PubNub App Context (Objects API) for users, channels, and memberships with full CRUD operations

Illuminate Analytics & Automation

• **manage_illuminate** - Manage PubNub Illuminate resources (business objects, queries, metrics, decisions, dashboards) with full CRUD, activation, analytics queries, action log inspection, and test data publishing

Insights Analytics

• **insights** - Query PubNub Insights for aggregated analytics metrics: unique channels/users, message volume, top-N rankings (channels, users, message types), country breakdowns, new vs. recurring user trends, user duration, and device type distributions. Requires a Service Integration API key with Account-level Insights Read access and Insights Premium tier.

Prompts

Healthcare & HIPAA Compliance

• **hipaa-chat-short** - Quick prompt to create HIPAA compliant chat applications
• **hipaa-chat-long** - Detailed prompt for HIPAA compliant chat with Pub/Sub, Presence, and App Context

React Development

• **react-app-short** - Scaffold a React app with PubNub Pub/Sub and Presence
• **react-app-long** - Comprehensive React app with real-time messaging, presence indicators, and user metadata

Gaming Applications

• **gamelobby-short** - Build multiplayer game lobby with chat and presence
• **gamelobby-long** - Advanced multiplayer lobby with team assignments and real-time features

OEM & Multi-Tenant Solutions

• **oem-client-management** - Create apps and configure keysets for OEM client deployments
• **multi-tenant-onboarding-short** - Implement automated tenant onboarding for SaaS applications
• **multi-tenant-onboarding-long** - Enterprise-grade multi-tenant onboarding with data isolation and error handling

Illuminate Analytics & Automation

• **illuminate-spam-detection** - Set up an Illuminate spam detection pipeline with escalating moderation actions
• **illuminate-reward-engagement** - Build an Illuminate engagement reward pipeline for live events and gaming
• **illuminate-use-case** - Guided setup of any Illuminate analytics and automation use case
• **illuminate-test-verify** - Test and verify an existing Illuminate configuration end-to-end

Insights Analytics

• **insights-snapshot** - Quick high-level analytics snapshot for a date range: unique channels, unique users, message volume, top 20 channels by messages, and anomaly callouts
• **insights-channel-analysis** - Deep dive into top channels by ranking category, channel naming patterns, and cross-category engagement comparisons
• **insights-user-growth** - New vs. recurring user trends, daily/weekly/monthly breakdowns, top countries, and whale user identification
• **insights-engagement-deep-dive** - Average user duration, session-length bucket histogram, top channels by user-minutes, and device-type breakdown across publishes, subscribers, and unique users

Resources

• **pubnub_sdk_docs** - Access PubNub SDK documentation via URI scheme: pubnub-docs://sdk/{language}/{feature}

Supported languages: asyncio, c-core, c-sharp, dart, freertos, go, java, javascript, kotlin, mbed, objective-c, php, posix-c, posix-cpp, python, ruby, rust, swift, unity, unreal, windows-c, windows-cpp

Supported features: access-manager, access-manager-v2, channel-groups, configuration, encryption, files, message-actions, misc, mobile-push, objects, presence, publish-and-subscribe, storage-and-playback

• **pubnub_chat_sdk_docs** - Access PubNub Chat SDK documentation via URI scheme: pubnub-docs://chat-sdk/{language}/{feature}

Supported Languages: javascript, kotlin, swift, unity, unreal

Supported Features: channels-create, channels-delete, channels-details, channels-invite, channels-join, channels-leave, channels-list, channels-membership, channels-references, channels-typing-indicator, channels-updates, channels-watch, connection-management, custom-events, error-logging, messages-delete, messages-details, messages-drafts, messages-files, messages-forward, messages-history, messages-links, messages-moderation, messages-pinned, messages-quotes, messages-reactions, messages-read-receipts, messages-restore, messages-send-receive, messages-threads, messages-unread, messages-updates, moderation, push-notifications, users-create, users-delete, users-details, users-list, users-mentions, users-moderation, users-moderation-user, users-permissions, users-presence, users-updates, utility-methods