🔔 PushNotif MCP Server (pushnotif-mcp-server)

🔔 PushNotif MCP Server (`pushnotif-mcp-server`)

License: MIT

Official open-source Model Context Protocol (MCP) Server implementation for PushNotif.biz.id — allowing AI coding assistants (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and Glama) to register accounts, generate SDK snippets, broadcast Web Push (VAPID) & Mobile Push (Android FCM / iOS APNs), configure In-App Popup Banners, and manage QRIS credits.

📦 Repository Architecture (Open-Source MCP Server Implementation)

This repository contains the complete, runnable MCP Server implementation built on @modelcontextprotocol/sdk:

src/index.js — Full Stdio MCP Server implementation (@modelcontextprotocol/sdk) exposing all 17 PushNotif tools (ListToolsRequestSchema & CallToolRequestSchema).
Dockerfile — Containerized build for Glama.ai automated inspection and local Docker execution.
package.json — Node.js ES Module package (bin: pushnotif-mcp).
glama.json & smithery.yaml — Registry metadata manifests.

🚀 Quick Start (Local Stdio MCP Server)

Option 1: Run via Node.js / `npx` (Stdio)

Clone and install dependencies:

git clone https://github.com/AarsyDesign/pushnotif-mcp.git
cd pushnotif-mcp
npm install

Add to your claude_desktop_config.json or .cursor/mcp.json:

{
  "mcpServers": {
    "pushnotif": {
      "command": "node",
      "args": ["/absolute/path/to/pushnotif-mcp/src/index.js"],
      "env": {
        "PUSHNOTIF_API_KEY": "pn_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

Option 2: Run via Docker (Stdio)

docker build -t pushnotif-mcp .
docker run -i --rm -e PUSHNOTIF_API_KEY=pn_live_YOUR_API_KEY_HERE pushnotif-mcp

Option 3: Direct Streamable HTTP Endpoint

You can also connect directly via Streamable HTTP at https://pushnotif.biz.id/mcp with Authorization: Bearer pn_live_YOUR_API_KEY_HERE.

🛠️ Available Tools (15 Full-Lifecycle Tools)

Account Onboarding (No API Key Required)

request_registration_otp — Send 6-digit verification OTP to user email (includes automatic duplicate email check).
register_new_account — Verify OTP, create a new PushNotif account (+1,000 Free Quota Credits forever), register first website, and return api_key (pn_live_...).
login_existing_account — Authenticate an existing account with email & password to retrieve its api_key.

Workspace, Web Push, Mobile Push & In-App Automation

list_apps — List all registered websites/apps, active subscriber counts, and credit balance.
create_app — Register a new website or mobile app and generate VAPID keys.
get_integration_guide — Generate copy-paste SDK snippets for HTML/JS, Laravel, Next.js/React, WordPress, Android (Kotlin), and iOS (Swift).
send_push_notification — Broadcast instant Web Push (VAPID), Android (FCM), and iOS (APNs) notifications.
schedule_push_notification — Schedule one-time or recurring (daily / weekly) push campaigns.
configure_inapp_banner — Configure In-App Popup Modals, Top Sticky Bars, Bottom Slide Cards, or Live Activity Toasts.
configure_rss_autopush, configure_payment_webhook (Midtrans, Xendit, Mayar, WooCommerce & GitHub) — Configure automated RSS / Sitemap / Atom feed monitoring.
configure_mobile_credentials — Upload Firebase FCM Service Account JSON or Apple APNs .p8 credentials.
list_subscribers — View active subscriber device distribution and segments.
get_campaign_analytics — Inspect campaign delivery, click-through rate (CTR), and conversion metrics.
create_qris_invoice — Generate a live QRIS payment invoice (starting from Rp 1,000 / 5,000 Credits).
check_billing_and_qris_status — Check real-time QRIS payment status (PENDING / PAID) and credit balance.
update_app_branding — Update notification icon URL and automatic Welcome Push message.
update_profile — Update workspace display name or account password.

🔔 PushNotif MCP Server (pushnotif-mcp-server)