PushNotif Official MCP Server

What PushNotif Official MCP Server does

PushNotif Official MCP Server exposes PushNotif.biz.id operations through the Model Context Protocol. It supports account onboarding and login, application registration, notification delivery, subscriber segmentation, campaign reporting, transactional email, payment webhooks, and QRIS credit management.

The notification workflows span Web Push using VAPID, Android delivery through Firebase Cloud Messaging, and iOS delivery through Apple Push Notification service. Applications can also use in-app popup formats, social proof toast messages, RSS or sitemap-driven auto-push, and automated transactional email settings.

How it works

The repository contains a Node.js ES module built with the @modelcontextprotocol/sdk. Its stdio implementation advertises 19 tools through MCP tool-list and tool-call requests. An MCP client launches the server process and supplies the PushNotif API key through the environment.

For deployments that do not launch a local process, clients can connect to https://pushnotif.biz.id/mcp using streamable HTTP and a bearer token. The server can also run inside Docker with the API key passed into the container.

Account creation has a two-step email OTP flow and can return a new API key after registering the first website. Existing users can authenticate with email and password to retrieve their key. Authenticated operations then work against the PushNotif workspace and its registered websites or mobile apps.

Setup and configuration

Node.js 18 or newer is supported. For a local installation, clone the repository, run npm install, and configure an MCP client to launch src/index.js with Node.js. The required environment variable is:

• PUSHNOTIF_API_KEY — PushNotif API key used for authenticated operations.

The project also includes a Dockerfile. Build the image and run it interactively while passing PUSHNOTIF_API_KEY into the container. Alternatively, use the streamable HTTP endpoint with an Authorization: Bearer header containing the PushNotif key.

The server can be added to Claude Desktop or Cursor using their MCP configuration files. The project also identifies Claude Code, Windsurf, and Cline as supported AI coding clients.

Tools and capabilities

The 19 tools cover the following areas:

• Register a new account with email OTP verification or log in to an existing account.
• List, create, update, and permanently delete registered websites or mobile apps.
• Generate VAPID keys and manage notification branding, Firebase credentials, and Apple APNs credentials.
• Send immediate push notifications or schedule one-time and recurring daily or weekly campaigns.
• Configure in-app banners, social proof toasts, RSS or sitemap auto-push, and payment webhooks.
• Configure automated transactional email and send templated OTP, invoice, order-status, or security-alert messages.
• List subscribers, manage device audience tags, and inspect delivery, CTR, and conversion analytics.
• Create QRIS credit invoices and check payment status, credit ledger entries, and downloadable invoices.

The application listing tool can return ready-to-paste SDK snippets for HTML, Next.js, Laravel, WordPress, and Flutter.

Limitations and notes

Some onboarding actions are available without an API key, while workspace and delivery operations use authenticated access. Deleting an application permanently removes its subscribers, campaigns, and logs. Mobile push configuration requires the relevant Firebase service-account JSON or Apple APNs .p8 credentials, supplied through the application branding configuration. QRIS billing uses Indonesian rupiah credit invoices and reports payment states such as PENDING and PAID.