onesignal-mcp 1.0.0

package/README.md

@@ -0,0 +1,13 @@
+# onesignal-mcp
+
+Query the OneSignal API (free tier; use a current v2 Organization API key for ONESIGNAL_USER_KEY and the app REST API key for ONESIGNAL_APP_KEY, Basic auth).
+
+## Tools
+
+- `list_apps` — OneSignal apps.
+- `get_app` — App details by ID.
+- `list_notifications` — Recent notifications for an app.
+
+## Source
+
+[onesignal-mcp](https://github.com/mrfentmen/premium-mcps/tree/main/servers/onesignal-mcp)

package/dist/api.d.ts

@@ -0,0 +1,7 @@
+export declare class OneSignalError extends Error {
+    constructor(message: string);
+}
+export declare function errorMessage(e: unknown): string;
+export declare function listApps(): Promise<string>;
+export declare function getApp(appId: string): Promise<string>;
+export declare function listNotifications(appId: string, limit?: string): Promise<string>;

package/dist/api.js

@@ -0,0 +1,47 @@
+export class OneSignalError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "OneSignalError";
+    }
+}
+export function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+const UA = { "User-Agent": "awesome-mcps/1.0" };
+const BASE = "https://api.onesignal.com";
+function userHeaders() {
+    const k = process.env.ONESIGNAL_USER_KEY;
+    if (!k)
+        throw new OneSignalError("Set ONESIGNAL_USER_KEY (free OneSignal tier).");
+    return { ...UA, Accept: "application/json", Authorization: `Basic ${k}` };
+}
+function appHeaders() {
+    const k = process.env.ONESIGNAL_APP_KEY;
+    if (!k)
+        throw new OneSignalError("Set ONESIGNAL_APP_KEY (OneSignal app REST API key).");
+    return { ...UA, Accept: "application/json", Authorization: `Basic ${k}` };
+}
+async function get(path, headers) {
+    let res;
+    try {
+        res = await fetch(BASE + path, { headers });
+    }
+    catch (e) {
+        throw new OneSignalError(`Network error: ${e.message}`);
+    }
+    if (!res.ok) {
+        const body = (await res.text()).slice(0, 300);
+        throw new OneSignalError(`HTTP ${res.status}: ${body}`);
+    }
+    return res.text();
+}
+export function listApps() {
+    return get("/apps", userHeaders());
+}
+export function getApp(appId) {
+    return get(`/apps/${encodeURIComponent(appId)}`, userHeaders());
+}
+export function listNotifications(appId, limit) {
+    const n = Math.min(Number(limit ?? 10) || 10, 50);
+    return get(`/notifications?app_id=${encodeURIComponent(appId)}&limit=${n}`, appHeaders());
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,58 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { errorMessage, listApps, getApp, listNotifications, } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+const MUTATING = { readOnlyHint: false, openWorldHint: true };
+export function createServer() {
+    const server = new McpServer({
+        name: "onesignal-mcp",
+        version: "1.0.0",
+    });
+    server.registerTool("list_apps", {
+        title: "List apps",
+        description: "OneSignal apps.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async ({}) => {
+        try {
+            return text(await listApps());
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("get_app", {
+        title: "Get app",
+        description: "App details by ID.",
+        inputSchema: z.object({
+            app_id: z.string().describe("OneSignal app ID.")
+        }),
+        annotations: READ_ONLY,
+    }, async ({ app_id }) => {
+        try {
+            return text(await getApp(app_id));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("list_notifications", {
+        title: "List notifications",
+        description: "Recent notifications for an app.",
+        inputSchema: z.object({
+            app_id: z.string().describe("OneSignal app ID."),
+            limit: z.string().describe("Max results (default 10, max 50).").optional()
+        }),
+        annotations: READ_ONLY,
+    }, async ({ app_id, limit }) => {
+        try {
+            return text(await listNotifications(app_id, limit));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "onesignal-mcp",
+  "version": "1.0.0",
+  "description": "OneSignal push: apps and notifications. Needs keys.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/onesignal-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/premium-mcps.git"
+  },
+  "bin": {
+    "onesignal-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "rm -rf dist && tsc -p tsconfig.json && node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "onesignal",
+    "push",
+    "notifications",
+    "mobile"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}