neuron-mcp-server 1.0.0 → 1.1.0

package/scripts/test-delivahere-bot.ts

@@ -0,0 +1,128 @@
+#!/usr/bin/env tsx
+/**
+ * Demo script: Tests the DelivaHere bot via the Bot API.
+ *
+ * This script demonstrates programmatic interaction with the bot
+ * using the API key generated by setup-delivahere-bot.ts.
+ *
+ * Usage:
+ *   NEURON_API_KEY=nrn_... tsx scripts/test-delivahere-bot.ts
+ */
+
+import axios from "axios";
+
+const API = process.env.NEURON_API_URL || "http://localhost:4000/api/v1";
+const API_KEY = process.env.NEURON_API_KEY;
+
+if (!API_KEY) {
+  console.error("Error: NEURON_API_KEY environment variable is required.");
+  console.error("Run setup-delivahere-bot.ts first to get an API key.");
+  process.exit(1);
+}
+
+async function botApi(method: string, path: string, data?: unknown, params?: Record<string, string>) {
+  const res = await axios({
+    method,
+    url: `${API}/bot-api/${path}`,
+    data,
+    params,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${API_KEY}`,
+    },
+  });
+  return res.data;
+}
+
+function separator(title: string) {
+  console.log(`\n${"=".repeat(60)}`);
+  console.log(`  ${title}`);
+  console.log(`${"=".repeat(60)}\n`);
+}
+
+async function main() {
+  const phone = "+2348012345678";
+
+  separator("Test 1: Get Bot Details");
+  const bot = await botApi("GET", "bot");
+  console.log(`Bot: ${bot.data.name}`);
+  console.log(`Model: ${bot.data.llmModel}`);
+  console.log(`Active: ${bot.data.isActive}`);
+
+  separator("Test 2: Initial Greeting");
+  const greeting = await botApi("POST", "chat", {
+    message: "Hi, I need to send a package",
+    contactPhone: phone,
+    contactName: "Demo Customer",
+  });
+  console.log(`Response (${greeting.data.latencyMs}ms, ${greeting.data.tokensUsed} tokens):`);
+  console.log(greeting.data.response);
+  const conversationId = greeting.data.conversationId;
+
+  separator("Test 3: Provide Delivery Details");
+  const details = await botApi("POST", "chat", {
+    message:
+      "I want to send a laptop from 15 Allen Avenue, Ikeja, Lagos to 23 Wuse Zone 5, Abuja. " +
+      "It weighs about 3kg, small size. I'd like it picked up tomorrow morning and delivered within 2 days. " +
+      "Please handle with care, it's fragile.",
+    contactPhone: phone,
+  });
+  console.log(`Response (${details.data.latencyMs}ms, ${details.data.tokensUsed} tokens):`);
+  console.log(details.data.response);
+
+  separator("Test 4: Ask About Pricing");
+  const pricing = await botApi("POST", "chat", {
+    message: "How much will this delivery cost approximately?",
+    contactPhone: phone,
+  });
+  console.log(`Response (${pricing.data.latencyMs}ms, ${pricing.data.tokensUsed} tokens):`);
+  console.log(pricing.data.response);
+
+  separator("Test 5: Ask About Tracking");
+  const tracking = await botApi("POST", "chat", {
+    message: "How can I track my package once it's picked up?",
+    contactPhone: phone,
+  });
+  console.log(`Response (${tracking.data.latencyMs}ms, ${tracking.data.tokensUsed} tokens):`);
+  console.log(tracking.data.response);
+
+  separator("Test 6: List Conversations");
+  const convos = await botApi("GET", "conversations");
+  console.log(`Total conversations: ${convos.data.total}`);
+  console.log(
+    `Conversations: ${convos.data.data.map((c: { contactName: string; status: string }) => `${c.contactName} (${c.status})`).join(", ")}`,
+  );
+
+  separator("Test 7: Get Conversation Messages");
+  const messages = await botApi("GET", `conversations/${conversationId}/messages`);
+  console.log(`Messages in conversation: ${messages.data.length}`);
+  for (const msg of messages.data.slice(-4)) {
+    const role = msg.role.toUpperCase().padEnd(10);
+    const content = (msg.content || "").slice(0, 100);
+    console.log(`  [${role}] ${content}${msg.content?.length > 100 ? "..." : ""}`);
+  }
+
+  separator("Test 8: Queue a WhatsApp Message");
+  try {
+    const send = await botApi("POST", "send", {
+      to: phone,
+      message: "Your delivery request has been received! We'll notify you when bids come in.",
+    });
+    console.log(`Message queued: ${JSON.stringify(send.data)}`);
+  } catch (err: unknown) {
+    const axErr = err as { response?: { data?: unknown } };
+    console.log(
+      `Expected: Bot may not have WhatsApp channel assigned.`,
+    );
+    console.log(`Response: ${JSON.stringify(axErr.response?.data)}`);
+  }
+
+  separator("All Tests Complete");
+  console.log("The DelivaHere bot is working correctly via the Bot API!");
+  console.log(`Conversation ID: ${conversationId}`);
+}
+
+main().catch((err) => {
+  console.error("Test failed:", err.response?.data || err.message);
+  process.exit(1);
+});

package/scripts/update-letschop-prompt.ts

@@ -0,0 +1,194 @@
+#!/usr/bin/env tsx
+/**
+ * Updates the LetsChop bot's system prompt with:
+ * 1. Strict group chat engagement rules (respond only when necessary)
+ * 2. Spam detection and deletion policy
+ *
+ * Usage:
+ *   NEURON_EMAIL=admin@example.com NEURON_PASSWORD=secret tsx scripts/update-letschop-prompt.ts
+ */
+
+import axios from "axios";
+
+const API = process.env.NEURON_API_URL || "http://localhost:4000/api/v1";
+const EMAIL = process.env.NEURON_EMAIL || "a.rasheedalabi@gmail.com";
+const PASSWORD = process.env.NEURON_PASSWORD || "12345678";
+
+let token = "";
+
+async function api(method: string, path: string, data?: unknown) {
+  const res = await axios({
+    method,
+    url: `${API}/${path}`,
+    data,
+    headers: {
+      "Content-Type": "application/json",
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+    },
+  });
+  return res.data;
+}
+
+async function main() {
+  console.log("=== LetsChop Bot Prompt Update ===\n");
+
+  // 1. Login
+  console.log("1. Logging in...");
+  const auth = await api("POST", "auth/login", {
+    email: EMAIL,
+    password: PASSWORD,
+  });
+  token = auth.data.accessToken;
+  console.log(`   Logged in as ${EMAIL}\n`);
+
+  // 2. Find the LetsChop bot
+  console.log("2. Finding LetsChop bot...");
+  const botsRes = await api("GET", "bots");
+  const bots = botsRes.data?.data ?? botsRes.data ?? [];
+  const letsChopBot = bots.find(
+    (b: any) => b.name?.toLowerCase().includes("letschop") || b.name?.toLowerCase().includes("lets chop"),
+  );
+
+  if (!letsChopBot) {
+    console.error("   LetsChop bot not found! Available bots:");
+    for (const b of bots) {
+      console.error(`   - ${b.name} (${b.id})`);
+    }
+    process.exit(1);
+  }
+  console.log(`   Found: ${letsChopBot.name} (${letsChopBot.id})\n`);
+
+  // 3. Update system prompt + metadata with newsletter JID
+  console.log("3. Updating system prompt and metadata...");
+  await api("PUT", `bots/${letsChopBot.id}`, {
+    systemPrompt: SYSTEM_PROMPT,
+    assignment: "LetsChop community assistant and group moderator for WhatsApp food ordering groups.",
+    responsibilities: [
+      "Help users discover meals, place orders, and navigate the LetsChop platform",
+      "Detect and delete spam messages (external group links, scams, unsolicited DM requests)",
+      "Occasionally enrich group conversations with relevant food tips, meal suggestions, or fun prompts",
+      "Answer direct questions about LetsChop services, menus, or ordering process",
+      "Post interesting food content, meal highlights, and community updates to the WhatsApp Channel",
+    ],
+    metadata: {
+      ...(letsChopBot.metadata ?? {}),
+      newsletterJid: "120363425082349937@newsletter",
+      groupFilter: {
+        botNames: ["lisa", "letschop", "lets chop"],
+        triggerKeywords: [
+          "menu", "order", "deliver", "delivery", "price",
+          "how much", "available", "today's meal", "what's cooking",
+          "help", "support", "complain", "app", "issues", "download", "question",
+        ],
+        detectSpam: true,
+      },
+    },
+  });
+  console.log("   System prompt and metadata updated.\n");
+
+  // 4. Enable built-in tools
+  console.log("4. Enabling built-in tools...");
+  try {
+    await api("PUT", `builtin-tools/bot/${letsChopBot.id}/bulk`, {
+      settings: [
+        { toolId: "delete_message", enabled: true },
+        { toolId: "post_to_channel", enabled: true },
+        { toolId: "post_status", enabled: true },
+      ],
+    });
+    console.log("   delete_message, post_to_channel, and post_status tools enabled.\n");
+  } catch (err: any) {
+    console.warn(`   Warning: Could not enable tools: ${err.message}\n`);
+  }
+
+  console.log("=== Update Complete ===");
+  console.log(`Bot: ${letsChopBot.name} (${letsChopBot.id})`);
+  console.log("Changes:");
+  console.log("  - System prompt updated with group engagement rules + spam policy");
+  console.log("  - delete_message built-in tool enabled");
+}
+
+// ---------------------------------------------------------------------------
+// System Prompt
+// ---------------------------------------------------------------------------
+
+const SYSTEM_PROMPT = `You are LetsChop's assistant in a WhatsApp food ordering community. You help users discover meals, place orders, and keep the group running smoothly.
+
+## Group Chat Engagement Rules
+
+You are in a group chat. Most messages are NOT for you. Follow these rules strictly:
+
+### RESPOND to these (and ONLY these):
+- Someone directly mentions you by name, tags you, or asks you a question
+- Someone asks a question about LetsChop — the menu, how to order, delivery, pricing, or anything related to the platform
+- Someone needs help with an order (tracking, issues, complaints)
+- A message is spam (see Spam Policy below) — delete it and warn the sender
+
+### STAY SILENT for these (do NOT respond):
+- Members chatting with each other about anything — food, life, banter, jokes
+- Someone sharing their opinion, reaction, or feedback to another member
+- General greetings like "good morning" to the group (unless someone greets you specifically)
+- Messages that are clearly part of an ongoing conversation between other people
+- Photos of food, memes, stickers, voice notes that aren't directed at you
+- Arguments or debates between members (stay out of it)
+
+### OCCASIONALLY (once or twice a day at most, not every conversation):
+- Drop a short, natural nudge when the group has been quiet for a while: a meal suggestion, a fun food question, or a gentle reminder about today's menu — keep it brief, casual, and non-pushy
+- Add a genuinely useful comment to an ongoing food conversation ONLY if you have something specific and valuable to contribute (e.g. "that dish is actually on today's menu if anyone wants to try it")
+- React to interesting food posts with an emoji instead of a full message
+
+### Hard Rules:
+- When in doubt, DO NOT respond. Silence is always better than an unnecessary message.
+- Never respond to two consecutive messages from different people in a row — if you just responded to something, stay quiet for the next few messages unless directly addressed.
+- Never repeat information you already shared in the same conversation.
+- Keep responses short. One to three sentences max unless someone asked a detailed question.
+- Do not start messages with "Hey everyone!" or similar broadcast-style greetings.
+- Do not explain what you are or what you can do unless someone asks.
+
+## Spam & Moderation Policy
+
+When a message matches ANY of the spam patterns below, immediately delete it using the delete_message tool and send a brief warning. Do NOT engage with the spam content.
+
+### Spam Patterns (DELETE immediately):
+1. **External WhatsApp group links** — Messages containing chat.whatsapp.com/join links or invitations to join other WhatsApp groups
+2. **Unsolicited DM requests** — Users asking others to "DM me", "inbox me", "check your inbox", or similar private message solicitations, UNLESS they have recently shared a LetsChop menu link or are clearly following up on an existing order conversation
+3. **External platform promotion** — Links to competing food platforms, unrelated Telegram/Discord groups, or promotional content not related to LetsChop
+4. **Scam patterns** — Messages promoting crypto/forex schemes, "double your money" offers, fake job postings, MLM pitches, or phishing links
+5. **Offensive content** — Hate speech, slurs, explicit content, or deliberately inflammatory messages unrelated to food ordering
+6. **Chain messages** — "Forward this to 10 people" or similar chain/broadcast spam
+7. **Unsolicited advertising** — Promoting products or services unrelated to food or the LetsChop community
+
+### NOT Spam (do NOT delete):
+- Normal food ordering conversations, questions about the menu, delivery inquiries
+- Users sharing their LetsChop meal posts or menu links
+- General friendly conversation between community members about food
+- Feedback or complaints about LetsChop service (even if negative or harsh)
+- Users coordinating group orders
+- Off-topic but harmless conversation between members (this is not your problem, just ignore it)
+
+### After Deleting:
+- Send ONE brief warning: "[Name], that message was removed — [brief reason]. Please keep conversations relevant to the LetsChop community."
+- For repeat offenders (same person warned before in recent history), mention it's a repeat but continue deleting.
+- Never delete messages you're unsure about. When in doubt, leave it alone.
+
+## WhatsApp Channel
+
+You have a WhatsApp Channel where you can post content for subscribers using the post_to_channel tool. Use it to share things like:
+- Meal of the day highlights or chef spotlights
+- Quick food tips, recipes, or fun food facts
+- Community milestones or announcements
+- Interesting food-related content that subscribers would enjoy
+
+Post to the channel at most once or twice a day, and only when you have something genuinely worth sharing. Do not repost group conversations to the channel. Keep channel posts concise and engaging.
+
+## Communication Style
+- Be casual and warm — you're part of the community, not a corporate bot
+- Use simple, conversational Nigerian English where natural
+- Keep it brief. No walls of text.
+- No emojis in every message — use them sparingly and naturally
+- Never be preachy, condescending, or overly enthusiastic`;
+
+main().catch((err) => {
+  console.error("Update failed:", err.response?.data || err.message);
+  process.exit(1);
+});

package/server.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.conquext/neuron",
+  "description": "AI-powered WhatsApp chatbot platform with 315 tools for bots, campaigns, and contacts.",
+  "repository": {
+    "url": "https://github.com/conquext/neuron",
+    "source": "github"
+  },
+  "version": "1.1.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.neuron.ng/mcp"
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "neuron-mcp-server",
+      "version": "1.1.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

package/smithery.yaml

@@ -0,0 +1,19 @@
+# Smithery configuration file: https://smithery.ai/docs/config#smitheryyaml
+
+startCommand:
+  type: stdio
+
+configSchema:
+  type: object
+  properties:
+    apiUrl:
+      type: string
+      default: "https://api.neuron.ng/api/v1"
+      description: Base URL of the Neuron API server.
+    authToken:
+      type: string
+      description: Pre-configured JWT or MCP token for authentication. If omitted, use the neuron_login tool to authenticate interactively.
+
+commandFunction:
+  |-
+  (config) => ({ command: 'node', args: ['dist/index.js'], env: { NEURON_API_URL: config.apiUrl || 'https://api.neuron.ng/api/v1', ...(config.authToken ? { NEURON_AUTH_TOKEN: config.authToken } : {}) } })

package/src/client.ts

@@ -0,0 +1,169 @@
+import axios, { AxiosError } from "axios";
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// Resolve API URL: prefer NEURON_API_URL if it points to a real server (not Docker-internal hostnames)
+const envUrl = process.env.NEURON_API_URL || "";
+const isDockerInternal = envUrl.includes("neuron-api:") || (envUrl.includes("localhost") && !envUrl.includes("https://"));
+const DEFAULT_BASE_URL = isDockerInternal ? "https://api.neuron.ng/api/v1" : (envUrl || "https://api.neuron.ng/api/v1");
+
+let baseUrl = DEFAULT_BASE_URL;
+
+// Token vault: stores tokens per base URL so switching instances preserves auth
+const tokenVault: Record<string, string> = {};
+
+const TOKEN_CACHE_DIR = join(homedir(), ".neuron");
+const TOKEN_CACHE_FILE = join(TOKEN_CACHE_DIR, "mcp-token-cache.json");
+
+function readCachedTokens(): Record<string, string> {
+  try {
+    const raw = readFileSync(TOKEN_CACHE_FILE, "utf-8");
+    const cache = JSON.parse(raw);
+    // Support legacy single-entry format
+    if (cache.baseUrl && cache.token && !cache.instances) {
+      return { [cache.baseUrl]: cache.token };
+    }
+    // Multi-instance format
+    if (cache.instances && typeof cache.instances === "object") {
+      return cache.instances as Record<string, string>;
+    }
+  } catch {
+    // No cache or unreadable — that's fine
+  }
+  return {};
+}
+
+function writeCachedTokens(): void {
+  try {
+    mkdirSync(TOKEN_CACHE_DIR, { recursive: true, mode: 0o700 });
+    writeFileSync(
+      TOKEN_CACHE_FILE,
+      JSON.stringify({ instances: tokenVault, activeBaseUrl: baseUrl }),
+      { mode: 0o600 },
+    );
+  } catch {
+    // Non-critical — best effort
+  }
+}
+
+// Initialize: load all cached tokens into the vault, then set active token
+const cachedTokens = readCachedTokens();
+for (const [url, token] of Object.entries(cachedTokens)) {
+  tokenVault[url] = token;
+}
+
+let authToken = process.env.NEURON_AUTH_TOKEN || tokenVault[baseUrl] || "";
+
+export function setAuthToken(token: string): void {
+  authToken = token;
+  if (token) {
+    tokenVault[baseUrl] = token;
+  } else {
+    delete tokenVault[baseUrl];
+  }
+  writeCachedTokens();
+}
+
+export function getAuthToken(): string {
+  return authToken;
+}
+
+export function getBaseUrl(): string {
+  return baseUrl;
+}
+
+export function setBaseUrl(url: string): void {
+  // Save current token for current instance
+  if (authToken) {
+    tokenVault[baseUrl] = authToken;
+  }
+  // Switch to new instance
+  baseUrl = url;
+  // Restore token from vault if we've authenticated with this instance before
+  authToken = tokenVault[url] || "";
+  writeCachedTokens();
+}
+
+export function listInstances(): Array<{ url: string; active: boolean; authenticated: boolean }> {
+  const urls = new Set<string>([baseUrl, ...Object.keys(tokenVault)]);
+  return Array.from(urls).map((url) => ({
+    url,
+    active: url === baseUrl,
+    authenticated: !!tokenVault[url],
+  }));
+}
+
+interface ApiResponse<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: { message: string; code: string; details?: unknown };
+}
+
+export async function api<T = unknown>(
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE",
+  endpoint: string,
+  data?: unknown,
+  params?: Record<string, string | number | undefined>,
+  headers?: Record<string, string>,
+): Promise<ApiResponse<T>> {
+  try {
+    const cleanParams: Record<string, string | number> = {};
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined) cleanParams[k] = v;
+      }
+    }
+
+    const cleanEndpoint = endpoint.replace(/^\/+/, "");
+    const response = await axios({
+      method,
+      url: `${baseUrl}/${cleanEndpoint}`,
+      data,
+      params: Object.keys(cleanParams).length > 0 ? cleanParams : undefined,
+      timeout: 60000,
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+        ...headers,
+      },
+    });
+    return response.data as ApiResponse<T>;
+  } catch (error) {
+    if (error instanceof AxiosError && error.response?.data) {
+      return error.response.data as ApiResponse<T>;
+    }
+    throw error;
+  }
+}
+
+export function handleError(error: unknown): string {
+  if (error instanceof AxiosError) {
+    if (error.response) {
+      const body = error.response.data as ApiResponse;
+      const msg = body?.error?.message || `HTTP ${error.response.status}`;
+      return `Error: ${msg}`;
+    }
+    const url = error.config?.url || baseUrl;
+    if (error.code === "ECONNABORTED") return `Error: Request timed out connecting to ${url}`;
+    if (error.code === "ECONNREFUSED") {
+      return `Error: Connection refused to ${url}. Try: neuron_login({ token: "your-mcp-token" }) with a token from the Neuron dashboard.`;
+    }
+    if (error.code === "ENOTFOUND") return `Error: DNS lookup failed for ${url}. Check your network connection.`;
+    return `Error: Network error (${error.code || "unknown"}): ${error.message} — URL: ${url}`;
+  }
+  return `Error: ${error instanceof Error ? error.message : String(error)}`;
+}
+
+export function jsonResult(data: unknown): { content: Array<{ type: "text"; text: string }> } {
+  return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
+}
+
+export function textResult(text: string): { content: Array<{ type: "text"; text: string }> } {
+  return { content: [{ type: "text" as const, text }] };
+}
+
+export function errorResult(error: unknown): { content: Array<{ type: "text"; text: string }>; isError: true } {
+  return { content: [{ type: "text" as const, text: handleError(error) }], isError: true };
+}