neuron-mcp-server 1.0.0

package/dist/tools/webhooks.js

@@ -0,0 +1,124 @@
+import { z } from "zod";
+import { api, jsonResult, errorResult } from "../client.js";
+/**
+ * Register webhook tools (inbound webhooks that trigger bot actions)
+ */
+export function registerWebhooksTools(server) {
+    // 1. Create Webhook
+    server.registerTool("neuron_create_webhook", {
+        title: "Create Webhook",
+        description: "Create a new inbound webhook that triggers bot actions when called",
+        inputSchema: z.object({
+            botId: z.string().describe("The ID of the bot to create the webhook for"),
+            name: z.string().describe("Name of the webhook"),
+            slug: z.string().optional().describe("URL-friendly slug for the webhook endpoint"),
+            eventType: z.string().optional().describe("Type of event this webhook handles"),
+            processingPrompt: z.string().optional().describe("Prompt to guide bot processing of webhook data"),
+            isActive: z.boolean().optional().describe("Whether the webhook is active (default: true)"),
+        }),
+        annotations: {
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const { botId, ...body } = args;
+        const response = await api("POST", `/webhooks/bot/${botId}`, body);
+        if (response.success) {
+            return jsonResult(response.data);
+        }
+        else {
+            return errorResult(response.error || "Failed to create webhook");
+        }
+    });
+    // 2. List Webhooks
+    server.registerTool("neuron_list_webhooks", {
+        title: "List Webhooks",
+        description: "List all inbound webhooks configured for a specific bot",
+        inputSchema: z.object({
+            botId: z.string().describe("The ID of the bot to list webhooks for"),
+        }),
+        annotations: {
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const response = await api("GET", `/webhooks/bot/${args.botId}`);
+        if (response.success) {
+            return jsonResult(response.data);
+        }
+        else {
+            return errorResult(response.error || "Failed to list webhooks");
+        }
+    });
+    // 3. Update Webhook
+    server.registerTool("neuron_update_webhook", {
+        title: "Update Webhook",
+        description: "Update an existing webhook configuration",
+        inputSchema: z.object({
+            id: z.string().describe("The ID of the webhook to update"),
+            name: z.string().optional().describe("Updated name of the webhook"),
+            eventType: z.string().optional().describe("Updated event type"),
+            processingPrompt: z.string().optional().describe("Updated processing prompt"),
+            isActive: z.boolean().optional().describe("Whether the webhook should be active"),
+        }),
+        annotations: {
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const { id, ...body } = args;
+        const response = await api("PUT", `/webhooks/${id}`, body);
+        if (response.success) {
+            return jsonResult(response.data);
+        }
+        else {
+            return errorResult(response.error || "Failed to update webhook");
+        }
+    });
+    // 4. Delete Webhook
+    server.registerTool("neuron_delete_webhook", {
+        title: "Delete Webhook",
+        description: "Delete an inbound webhook from a bot",
+        inputSchema: z.object({
+            id: z.string().describe("The ID of the webhook to delete"),
+        }),
+        annotations: {
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const response = await api("DELETE", `/webhooks/${args.id}`);
+        if (response.success) {
+            return jsonResult(response.data || { message: "Webhook deleted successfully" });
+        }
+        else {
+            return errorResult(response.error || "Failed to delete webhook");
+        }
+    });
+    // 5. Get Webhook Logs
+    server.registerTool("neuron_get_webhook_logs", {
+        title: "Get Webhook Logs",
+        description: "Retrieve execution logs for a webhook to monitor activity and debug issues",
+        inputSchema: z.object({
+            id: z.string().describe("The ID of the webhook to get logs for"),
+            page: z.number().optional().describe("Page number for pagination (default: 1)"),
+            limit: z.number().optional().describe("Number of logs per page (default: 20)"),
+        }),
+        annotations: {
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const { id, page, limit } = args;
+        const params = {};
+        if (page !== undefined) {
+            params.page = String(page);
+        }
+        if (limit !== undefined) {
+            params.limit = String(limit);
+        }
+        const response = await api("GET", `/webhooks/${id}/logs`, undefined, params);
+        if (response.success) {
+            return jsonResult(response.data);
+        }
+        else {
+            return errorResult(response.error || "Failed to get webhook logs");
+        }
+    });
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "neuron-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Neuron — the WhatsApp automation platform. 120+ tools for AI chatbots, broadcasts, campaigns, contacts, knowledge bases, newsletters, and more.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "neuron-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "whatsapp",
+    "whatsapp-api",
+    "whatsapp-automation",
+    "chatbot",
+    "ai",
+    "claude",
+    "cursor",
+    "neuron",
+    "messaging",
+    "broadcast",
+    "campaign",
+    "knowledge-base",
+    "newsletter",
+    "contacts"
+  ],
+  "author": "Neuron <hello@neuron.ng>",
+  "license": "MIT",
+  "homepage": "https://neuron.ng",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/conquext/neuron-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/conquext/neuron-mcp-server/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "axios": "^1.7.9",
+    "dotenv": "^17.3.1",
+    "express": "^5.2.1",
+    "form-data": "^4.0.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}