PushNotif Official MCP Server README

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

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, Social Proof Toasts, Transactional Email OTP, 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 19 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:

bash

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:

config.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)

Terminal

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 (19 Full-Lifecycle Tools)

Account Onboarding (No API Key Required)

register_new_account — Two-step onboarding to request a 6-digit email OTP or verify the OTP to create a new PushNotif account (+1,000 Free Quota Credits forever), register the first website, and return api_key (pn_live_...).
login_existing_account — Authenticate an existing account with email & password to retrieve its api_key and optionally update workspace profile name or password.

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

list_apps — List all registered websites/apps, active subscriber counts, credit balance, and optional ready-to-paste SDK snippets (html, nextjs, laravel, wordpress, flutter).
create_app — Register a new website or mobile app and generate VAPID keys.
update_app_branding — Update notification icon URL, automatic Welcome Push message, or upload Firebase FCM Service Account JSON / Apple APNs .p8 credentials.
delete_app — Permanently delete a registered application along with its subscribers, campaigns, and logs.
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, or Bottom Slide Cards.
configure_social_toast — Configure standalone on-site Live Activity Social Proof Toast popups.
configure_rss_autopush — Configure automated 24/7 RSS / Sitemap / Atom feed monitoring and auto-push.
configure_payment_webhook — Generate incoming webhook URLs for Midtrans, Xendit, Mayar, Lynk.id, Duitku, Tripay, WooCommerce, and GitHub, or trigger a live test event.
configure_email_automation — Configure per-app switches for Automated Transactional Emails (Order Paid Receipt, Welcome Email, Broadcast Mirror) and custom Reply-To.
send_transactional_email — Send 1-to-1 transactional emails (otp_code, payment_invoice, order_status, security_alert) via PushNotif's anti-phishing locked templates.
list_subscribers — View active subscriber device distribution and segment tags.
update_subscriber_tags — Assign, replace, or remove audience segment tags on subscriber devices.
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), credit ledger history, and downloadable PDF invoices.

🔔 PushNotif MCP Server (pushnotif-mcp-server)