verbo-mcp-server 0.1.4 → 0.2.1

package/dist/client.d.ts

@@ -14,9 +14,22 @@ export declare class VerboClient {
         greetingMessage?: string;
         faqData?: Record<string, string>[];
         businessHours?: Record<string, unknown>;
+        agentName?: string;
+        systemInstructions?: string;
+        tone?: "professional" | "friendly" | "formal" | "casual";
+        language?: string;
+        rules?: string[];
     }): Promise<unknown>;
     setupCrawl(url: string): Promise<unknown>;
     setupConnect(): Promise<unknown>;
     setupStatus(): Promise<unknown>;
     setupDisconnect(): Promise<unknown>;
+    knowledgeCrawl(url: string): Promise<unknown>;
+    knowledgeAdd(title: string, content: string): Promise<unknown>;
+    knowledgeList(): Promise<unknown>;
+    knowledgeDelete(id: string): Promise<unknown>;
+    webhookRegister(url: string, events: string[]): Promise<unknown>;
+    webhookList(): Promise<unknown>;
+    webhookDelete(id: string): Promise<unknown>;
+    getUsage(): Promise<unknown>;
 }

package/dist/client.js

@@ -7,43 +7,21 @@ class VerboClient {
     apiKey;
     constructor(apiKey, baseUrl) {
         this.apiKey = apiKey;
-        this.baseUrl = (baseUrl || "https://www.verbolab.co").replace(/\/$/, "");
+        this.baseUrl = (baseUrl || "https://verbolab.co").replace(/\/$/, "");
     }
     async request(path, options = {}) {
         const url = `${this.baseUrl}/api/v1${path}`;
-        let res;
-        try {
-            res = await fetch(url, {
-                ...options,
-                headers: {
-                    "Authorization": `Bearer ${this.apiKey}`,
-                    "Content-Type": "application/json",
-                    ...options.headers,
-                },
-            });
-        }
-        catch (err) {
-            throw new Error(`Could not connect to Verbo API at ${this.baseUrl}. Check your internet connection or VERBO_API_URL setting.`);
-        }
-        let data;
-        try {
-            data = await res.json();
-        }
-        catch {
-            throw new Error(`Verbo API returned invalid response (HTTP ${res.status}). The server may be temporarily unavailable — try again in a moment.`);
-        }
+        const res = await fetch(url, {
+            ...options,
+            headers: {
+                "Authorization": `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        const data = await res.json();
         if (!res.ok) {
-            const errorMsg = data.error || "Unknown error";
-            if (res.status === 401) {
-                throw new Error(`API key is invalid or revoked. Create a new key at ${this.baseUrl}/developers`);
-            }
-            if (res.status === 403) {
-                throw new Error(`Subscription expired or inactive. Upgrade at ${this.baseUrl}/settings/billing — ${errorMsg}`);
-            }
-            if (res.status === 429) {
-                throw new Error(`Rate limit exceeded. ${errorMsg}`);
-            }
-            throw new Error(`Verbo API error (${res.status}): ${errorMsg}`);
+            throw new Error(`Verbo API error (${res.status}): ${data.error || "Unknown error"}`);
         }
         return data;
     }
@@ -95,6 +73,45 @@ class VerboClient {
             body: JSON.stringify({}),
         });
     }
+    async knowledgeCrawl(url) {
+        return this.request("/knowledge/crawl", {
+            method: "POST",
+            body: JSON.stringify({ url }),
+        });
+    }
+    async knowledgeAdd(title, content) {
+        return this.request("/knowledge", {
+            method: "POST",
+            body: JSON.stringify({ title, content }),
+        });
+    }
+    async knowledgeList() {
+        return this.request("/knowledge");
+    }
+    async knowledgeDelete(id) {
+        return this.request("/knowledge", {
+            method: "DELETE",
+            body: JSON.stringify({ id }),
+        });
+    }
+    async webhookRegister(url, events) {
+        return this.request("/webhooks", {
+            method: "POST",
+            body: JSON.stringify({ url, events }),
+        });
+    }
+    async webhookList() {
+        return this.request("/webhooks");
+    }
+    async webhookDelete(id) {
+        return this.request("/webhooks", {
+            method: "DELETE",
+            body: JSON.stringify({ id }),
+        });
+    }
+    async getUsage() {
+        return this.request("/usage");
+    }
 }
 exports.VerboClient = VerboClient;
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.js

@@ -7,6 +7,9 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const client_js_1 = require("./client.js");
 const tools_js_1 = require("./tools.js");
 const setup_tools_js_1 = require("./setup-tools.js");
+const knowledge_tools_js_1 = require("./knowledge-tools.js");
+const webhook_tools_js_1 = require("./webhook-tools.js");
+const usage_tools_js_1 = require("./usage-tools.js");
 const apiKey = process.env.VERBO_API_KEY;
 if (!apiKey) {
     console.error("VERBO_API_KEY environment variable is required");
@@ -17,26 +20,6 @@ const client = new client_js_1.VerboClient(apiKey, baseUrl);
 const server = new mcp_js_1.McpServer({
     name: "Verbo",
     version: "0.1.0",
-}, {
-    instructions: `Verbo is an AI-powered WhatsApp customer service agent. You plug it into your product and it handles customer conversations automatically — answers questions, classifies intent, escalates complaints, follows up.
-
-## Setup workflow (run in order):
-1. verbo_setup_crawl — Crawl the business website to auto-extract name, products, FAQ, hours, tone. This configures the agent.
-2. verbo_setup_connect — Creates a WhatsApp instance. Returns a URL to scan a QR code in the browser.
-3. verbo_setup_status — Check if all steps are done. Shows what's missing.
-
-## After setup:
-- verbo_send_message — Send a WhatsApp message to any number
-- verbo_list_conversations — See recent customer conversations
-- verbo_get_conversation — Read messages in a specific conversation
-- verbo_agent_status — Check WhatsApp connection and business config
-- verbo_configure_agent — Update greeting, FAQ, or business hours
-- verbo_setup_disconnect — Disconnect WhatsApp when done
-
-## Important:
-- Do NOT search the web for information about Verbo. Everything you need is in these tools.
-- The crawl step takes 15-30 seconds. This is normal — it fetches multiple pages and uses AI extraction.
-- After connecting WhatsApp, the agent starts responding to incoming messages automatically.`,
 });
 for (const [name, tool] of Object.entries(tools_js_1.toolDefinitions)) {
     server.tool(name, tool.description, tool.schema, async (args) => {
@@ -68,6 +51,51 @@ for (const [name, tool] of Object.entries(setup_tools_js_1.setupToolDefinitions)
         }
     });
 }
+for (const [name, tool] of Object.entries(knowledge_tools_js_1.knowledgeToolDefinitions)) {
+    server.tool(name, tool.description, tool.schema, async (args) => {
+        try {
+            const result = await (0, knowledge_tools_js_1.executeKnowledgeTool)(client, name, args);
+            return { content: [{ type: "text", text: result }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+for (const [name, tool] of Object.entries(webhook_tools_js_1.webhookToolDefinitions)) {
+    server.tool(name, tool.description, tool.schema, async (args) => {
+        try {
+            const result = await (0, webhook_tools_js_1.executeWebhookTool)(client, name, args);
+            return { content: [{ type: "text", text: result }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+for (const [name, tool] of Object.entries(usage_tools_js_1.usageToolDefinitions)) {
+    server.tool(name, tool.description, tool.schema, async (args) => {
+        try {
+            const result = await (0, usage_tools_js_1.executeUsageTool)(client, name, args);
+            return { content: [{ type: "text", text: result }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

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

package/dist/knowledge-tools.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { type VerboClient } from "./client.js";
+export declare const knowledgeToolDefinitions: {
+    readonly verbo_knowledge_crawl: {
+        readonly description: "Crawl a URL and add the extracted content to the agent's knowledge base. Use this to teach the agent about specific pages, documentation, or product details beyond the initial setup crawl. Rate limited to 3 calls per 10 minutes.";
+        readonly schema: {
+            readonly url: z.ZodString;
+        };
+    };
+    readonly verbo_knowledge_add: {
+        readonly description: "Manually add a knowledge entry to the agent's knowledge base. Use this to add custom FAQs, policies, product details, or any structured information the agent should know.";
+        readonly schema: {
+            readonly title: z.ZodString;
+            readonly content: z.ZodString;
+        };
+    };
+    readonly verbo_knowledge_list: {
+        readonly description: "List all entries in the agent's knowledge base. Shows titles and IDs of all stored knowledge.";
+        readonly schema: {};
+    };
+    readonly verbo_knowledge_delete: {
+        readonly description: "Delete a knowledge entry from the agent's knowledge base by its ID. Use verbo_knowledge_list to find the ID.";
+        readonly schema: {
+            readonly id: z.ZodString;
+        };
+    };
+};
+export type KnowledgeToolName = keyof typeof knowledgeToolDefinitions;
+export declare function executeKnowledgeTool(client: VerboClient, name: string, args: Record<string, unknown>): Promise<string>;

package/dist/knowledge-tools.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.knowledgeToolDefinitions = void 0;
+exports.executeKnowledgeTool = executeKnowledgeTool;
+// packages/mcp-server/src/knowledge-tools.ts
+const zod_1 = require("zod");
+exports.knowledgeToolDefinitions = {
+    verbo_knowledge_crawl: {
+        description: "Crawl a URL and add the extracted content to the agent's knowledge base. Use this to teach the agent about specific pages, documentation, or product details beyond the initial setup crawl. Rate limited to 3 calls per 10 minutes.",
+        schema: {
+            url: zod_1.z.string().describe("URL to crawl and extract content from"),
+        },
+    },
+    verbo_knowledge_add: {
+        description: "Manually add a knowledge entry to the agent's knowledge base. Use this to add custom FAQs, policies, product details, or any structured information the agent should know.",
+        schema: {
+            title: zod_1.z.string().describe("Title or topic of the knowledge entry"),
+            content: zod_1.z.string().describe("Full content of the knowledge entry"),
+        },
+    },
+    verbo_knowledge_list: {
+        description: "List all entries in the agent's knowledge base. Shows titles and IDs of all stored knowledge.",
+        schema: {},
+    },
+    verbo_knowledge_delete: {
+        description: "Delete a knowledge entry from the agent's knowledge base by its ID. Use verbo_knowledge_list to find the ID.",
+        schema: {
+            id: zod_1.z.string().describe("ID of the knowledge entry to delete"),
+        },
+    },
+};
+async function executeKnowledgeTool(client, name, args) {
+    switch (name) {
+        case "verbo_knowledge_crawl": {
+            const result = await client.knowledgeCrawl(args.url);
+            return JSON.stringify(result, null, 2) +
+                "\n\n→ Content extracted and added to knowledge base. Use verbo_knowledge_list to see all entries.";
+        }
+        case "verbo_knowledge_add": {
+            const result = await client.knowledgeAdd(args.title, args.content);
+            return JSON.stringify(result, null, 2) +
+                "\n\n→ Knowledge entry added. Use verbo_knowledge_list to see all entries.";
+        }
+        case "verbo_knowledge_list": {
+            const result = await client.knowledgeList();
+            return JSON.stringify(result, null, 2) +
+                "\n\n→ Use verbo_knowledge_delete with an ID to remove an entry.";
+        }
+        case "verbo_knowledge_delete": {
+            const result = await client.knowledgeDelete(args.id);
+            return JSON.stringify(result, null, 2) +
+                "\n\n→ Knowledge entry deleted.";
+        }
+        default:
+            return JSON.stringify({ error: `Unknown knowledge tool: ${name}` });
+    }
+}
+//# sourceMappingURL=knowledge-tools.js.map

package/dist/knowledge-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-tools.js","sourceRoot":"","sources":["../src/knowledge-tools.ts"],"names":[],"mappings":";;;AAoCA,oDAgCC;AApED,6CAA6C;AAC7C,6BAAwB;AAGX,QAAA,wBAAwB,GAAG;IACtC,qBAAqB,EAAE;QACrB,WAAW,EACT,sOAAsO;QACxO,MAAM,EAAE;YACN,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SAClE;KACF;IACD,mBAAmB,EAAE;QACnB,WAAW,EACT,4KAA4K;QAC9K,MAAM,EAAE;YACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACnE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SACpE;KACF;IACD,oBAAoB,EAAE;QACpB,WAAW,EACT,+FAA+F;QACjG,MAAM,EAAE,EAAE;KACX;IACD,sBAAsB,EAAE;QACtB,WAAW,EACT,8GAA8G;QAChH,MAAM,EAAE;YACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SAC/D;KACF;CACO,CAAC;AAIJ,KAAK,UAAU,oBAAoB,CACxC,MAAmB,EACnB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,mGAAmG,CAAC;QACxG,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CACtC,IAAI,CAAC,KAAe,EACpB,IAAI,CAAC,OAAiB,CACvB,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,2EAA2E,CAAC;QAChF,CAAC;QACD,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,iEAAiE,CAAC;QACtE,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,gCAAgC,CAAC;QACrC,CAAC;QACD;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,2BAA2B,IAAI,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/setup-tools.js

@@ -27,41 +27,20 @@ exports.setupToolDefinitions = {
 async function executeSetupTool(client, name, args) {
     switch (name) {
         case "verbo_setup_crawl": {
-            try {
-                const result = await client.setupCrawl(args.url);
-                return JSON.stringify(result, null, 2) +
-                    "\n\n→ Business configured from website. Next: run verbo_setup_connect to connect WhatsApp.";
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                if (msg.includes("422") || msg.includes("enough content") || msg.includes("SPA")) {
-                    return `Crawl failed: the website appears to be a Single Page App (React, Vue, Angular) that renders via JavaScript. The crawler can only read server-rendered HTML.\n\n→ Use verbo_configure_agent instead to set up the agent manually. Ask the user about their business and set greeting_message, faq (array of {question, answer}), and business_hours.`;
-                }
-                throw err;
-            }
+            const result = await client.setupCrawl(args.url);
+            return JSON.stringify(result, null, 2);
         }
         case "verbo_setup_connect": {
             const result = await client.setupConnect();
-            const data = result;
-            const connectUrl = data.connectUrl || "";
-            return JSON.stringify(result, null, 2) +
-                `\n\n→ WhatsApp instance created. IMPORTANT: Tell the user to open ${connectUrl} in their browser and scan the QR code with their phone. After scanning, run verbo_setup_status to confirm the connection.`;
+            return JSON.stringify(result, null, 2);
         }
         case "verbo_setup_status": {
             const result = await client.setupStatus();
-            const data = result;
-            const ready = data.ready;
-            if (ready) {
-                return JSON.stringify(result, null, 2) +
-                    "\n\n→ All set! The AI agent is live and will respond to incoming WhatsApp messages automatically. Use verbo_send_message to send a test message.";
-            }
-            return JSON.stringify(result, null, 2) +
-                "\n\n→ Setup incomplete. Check the steps above and run the missing ones.";
+            return JSON.stringify(result, null, 2);
         }
         case "verbo_setup_disconnect": {
             const result = await client.setupDisconnect();
-            return JSON.stringify(result, null, 2) +
-                "\n\n→ WhatsApp disconnected. The phone number is free to use elsewhere.";
+            return JSON.stringify(result, null, 2);
         }
         default:
             return JSON.stringify({ error: `Unknown setup tool: ${name}` });

package/dist/setup-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-tools.js","sourceRoot":"","sources":["../src/setup-tools.ts"],"names":[],"mappings":";;;AA+BA,4CA6CC;AA5ED,yCAAyC;AACzC,6BAAwB;AAGX,QAAA,oBAAoB,GAAG;IAClC,iBAAiB,EAAE;QACjB,WAAW,EACT,mNAAmN;QACrN,MAAM,EAAE;YACN,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SACjE;KACF;IACD,mBAAmB,EAAE;QACnB,WAAW,EACT,+QAA+Q;QACjR,MAAM,EAAE,EAAE;KACX;IACD,kBAAkB,EAAE;QAClB,WAAW,EACT,uHAAuH;QACzH,MAAM,EAAE,EAAE;KACX;IACD,sBAAsB,EAAE;QACtB,WAAW,EACT,kKAAkK;QACpK,MAAM,EAAE,EAAE;KACX;CACO,CAAC;AAIJ,KAAK,UAAU,gBAAgB,CACpC,MAAmB,EACnB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC;gBAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBACpC,4FAA4F,CAAC;YACjG,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjF,OAAO,sVAAsV,CAAC;gBAChW,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,MAAiC,CAAC;YAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,qEAAqE,UAAU,4HAA4H,CAAC;QAChN,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAiC,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBACpC,kJAAkJ,CAAC;YACvJ,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,yEAAyE,CAAC;QAC9E,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,yEAAyE,CAAC;QAC9E,CAAC;QACD;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,IAAI,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}
+{"version":3,"file":"setup-tools.js","sourceRoot":"","sources":["../src/setup-tools.ts"],"names":[],"mappings":";;;AA+BA,4CAyBC;AAxDD,yCAAyC;AACzC,6BAAwB;AAGX,QAAA,oBAAoB,GAAG;IAClC,iBAAiB,EAAE;QACjB,WAAW,EACT,mNAAmN;QACrN,MAAM,EAAE;YACN,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SACjE;KACF;IACD,mBAAmB,EAAE;QACnB,WAAW,EACT,+QAA+Q;QACjR,MAAM,EAAE,EAAE;KACX;IACD,kBAAkB,EAAE;QAClB,WAAW,EACT,uHAAuH;QACzH,MAAM,EAAE,EAAE;KACX;IACD,sBAAsB,EAAE;QACtB,WAAW,EACT,kKAAkK;QACpK,MAAM,EAAE,EAAE;KACX;CACO,CAAC;AAIJ,KAAK,UAAU,gBAAgB,CACpC,MAAmB,EACnB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,IAAI,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/tools.d.ts

@@ -30,7 +30,7 @@ export declare const toolDefinitions: {
         readonly schema: {};
     };
     readonly verbo_configure_agent: {
-        readonly description: "Configure the AI agent behavior. Use this to manually set up the agent when verbo_setup_crawl can't extract info (e.g. SPA sites). You can set any combination of greeting, FAQ, and hours.";
+        readonly description: "Configure the AI agent behavior. Set greeting message, FAQ, business hours, agent name, system instructions, tone, language, and custom rules.";
         readonly schema: {
             readonly greeting_message: z.ZodOptional<z.ZodString>;
             readonly faq: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -38,6 +38,16 @@ export declare const toolDefinitions: {
                 answer: z.ZodString;
             }, z.core.$strip>>>;
             readonly business_hours: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            readonly agent_name: z.ZodOptional<z.ZodString>;
+            readonly system_instructions: z.ZodOptional<z.ZodString>;
+            readonly tone: z.ZodOptional<z.ZodEnum<{
+                professional: "professional";
+                friendly: "friendly";
+                formal: "formal";
+                casual: "casual";
+            }>>;
+            readonly language: z.ZodOptional<z.ZodString>;
+            readonly rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
         };
     };
 };

package/dist/tools.js

@@ -42,23 +42,43 @@ exports.toolDefinitions = {
         schema: {},
     },
     verbo_configure_agent: {
-        description: "Configure the AI agent behavior. Use this to manually set up the agent when verbo_setup_crawl can't extract info (e.g. SPA sites). You can set any combination of greeting, FAQ, and hours.",
+        description: "Configure the AI agent behavior. Set greeting message, FAQ, business hours, agent name, system instructions, tone, language, and custom rules.",
         schema: {
             greeting_message: zod_1.z
                 .string()
                 .optional()
-                .describe("Greeting message the AI sends to new customers on WhatsApp (e.g. 'Olá! Bem-vindo à Scinti. Como posso ajudar?')"),
+                .describe("Greeting message for new customers"),
             faq: zod_1.z
                 .array(zod_1.z.object({
-                question: zod_1.z.string().describe("A question customers commonly ask"),
-                answer: zod_1.z.string().describe("The answer the AI should give"),
+                question: zod_1.z.string(),
+                answer: zod_1.z.string(),
             }))
                 .optional()
-                .describe("List of FAQ entries the AI uses to answer customer questions"),
+                .describe("Frequently asked questions"),
             business_hours: zod_1.z
                 .record(zod_1.z.string(), zod_1.z.string())
                 .optional()
-                .describe("Business hours per weekday (e.g. { monday: '9:00-18:00', saturday: '9:00-13:00' })"),
+                .describe("Business hours (e.g. { monday: '9:00-18:00' })"),
+            agent_name: zod_1.z
+                .string()
+                .optional()
+                .describe("Display name for the AI agent (e.g. 'Sofia', 'Assistente Verbo')"),
+            system_instructions: zod_1.z
+                .string()
+                .optional()
+                .describe("Custom system instructions that define how the agent behaves and responds"),
+            tone: zod_1.z
+                .enum(["professional", "friendly", "formal", "casual"])
+                .optional()
+                .describe("Tone of voice for the agent's responses"),
+            language: zod_1.z
+                .string()
+                .optional()
+                .describe("Primary language for responses (e.g. 'pt-BR', 'en-US', 'es')"),
+            rules: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("List of custom rules the agent must follow (e.g. 'Never mention competitors')"),
         },
     },
 };
@@ -66,16 +86,14 @@ async function executeTool(client, name, args) {
     switch (name) {
         case "verbo_send_message": {
             const result = await client.sendMessage(args.to, args.message, args.image_url);
-            return JSON.stringify(result, null, 2) +
-                "\n\n→ Message sent. Use verbo_list_conversations to see the conversation.";
+            return JSON.stringify(result, null, 2);
         }
         case "verbo_list_conversations": {
             const result = await client.listConversations({
                 status: args.status,
                 limit: args.limit,
             });
-            return JSON.stringify(result, null, 2) +
-                "\n\n→ Use verbo_get_conversation with a conversation ID to see full messages.";
+            return JSON.stringify(result, null, 2);
         }
         case "verbo_get_conversation": {
             const result = await client.getConversation(args.conversation_id);
@@ -90,9 +108,13 @@ async function executeTool(client, name, args) {
                 greetingMessage: args.greeting_message,
                 faqData: args.faq,
                 businessHours: args.business_hours,
+                agentName: args.agent_name,
+                systemInstructions: args.system_instructions,
+                tone: args.tone,
+                language: args.language,
+                rules: args.rules,
             });
-            return JSON.stringify(result, null, 2) +
-                "\n\n→ Agent updated. Use verbo_setup_status to verify the full setup.";
+            return JSON.stringify(result, null, 2);
         }
         default:
             return JSON.stringify({ error: `Unknown tool: ${name}` });

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":";;;AA8FA,kCAiDC;AA/ID,mCAAmC;AACnC,6BAAwB;AAGX,QAAA,eAAe,GAAG;IAC7B,kBAAkB,EAAE;QAClB,WAAW,EACT,sEAAsE;QACxE,MAAM,EAAE;YACN,EAAE,EAAE,OAAC;iBACF,MAAM,EAAE;iBACR,QAAQ,CAAC,oCAAoC,CAAC;YACjD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5C,SAAS,EAAE,OAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sBAAsB,CAAC;SACpC;KACF;IACD,wBAAwB,EAAE;QACxB,WAAW,EACT,gEAAgE;QAClE,MAAM,EAAE;YACN,MAAM,EAAE,OAAC;iBACN,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;iBACxB,QAAQ,EAAE;iBACV,QAAQ,CAAC,kBAAkB,CAAC;YAC/B,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iCAAiC,CAAC;SAC/C;KACF;IACD,sBAAsB,EAAE;QACtB,WAAW,EACT,wDAAwD;QAC1D,MAAM,EAAE;YACN,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SACxD;KACF;IACD,kBAAkB,EAAE;QAClB,WAAW,EACT,uEAAuE;QACzE,MAAM,EAAE,EAAE;KACX;IACD,qBAAqB,EAAE;QACrB,WAAW,EACT,gJAAgJ;QAClJ,MAAM,EAAE;YACN,gBAAgB,EAAE,OAAC;iBAChB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,oCAAoC,CAAC;YACjD,GAAG,EAAE,OAAC;iBACH,KAAK,CACJ,OAAC,CAAC,MAAM,CAAC;gBACP,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;gBACpB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;aACnB,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CAAC,4BAA4B,CAAC;YACzC,cAAc,EAAE,OAAC;iBACd,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CACP,gDAAgD,CACjD;YACH,UAAU,EAAE,OAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kEAAkE,CAAC;YAC/E,mBAAmB,EAAE,OAAC;iBACnB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2EAA2E,CAAC;YACxF,IAAI,EAAE,OAAC;iBACJ,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;iBACtD,QAAQ,EAAE;iBACV,QAAQ,CAAC,yCAAyC,CAAC;YACtD,QAAQ,EAAE,OAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,8DAA8D,CAAC;YAC3E,KAAK,EAAE,OAAC;iBACL,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,+EAA+E,CAAC;SAC7F;KACF;CACO,CAAC;AAIJ,KAAK,UAAU,WAAW,CAC/B,MAAmB,EACnB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CACrC,IAAI,CAAC,EAAY,EACjB,IAAI,CAAC,OAAiB,EACtB,IAAI,CAAC,SAA+B,CACrC,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,0BAA0B,CAAC,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC;gBAC5C,MAAM,EAAE,IAAI,CAAC,MAA4B;gBACzC,KAAK,EAAE,IAAI,CAAC,KAA2B;aACxC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CACzC,IAAI,CAAC,eAAyB,CAC/B,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC;gBACzC,eAAe,EAAE,IAAI,CAAC,gBAAsC;gBAC5D,OAAO,EAAE,IAAI,CAAC,GAA2C;gBACzD,aAAa,EAAE,IAAI,CAAC,cAEP;gBACb,SAAS,EAAE,IAAI,CAAC,UAAgC;gBAChD,kBAAkB,EAAE,IAAI,CAAC,mBAAyC;gBAClE,IAAI,EAAE,IAAI,CAAC,IAAqE;gBAChF,QAAQ,EAAE,IAAI,CAAC,QAA8B;gBAC7C,KAAK,EAAE,IAAI,CAAC,KAA6B;aAC1C,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/usage-tools.d.ts

@@ -0,0 +1,9 @@
+import { type VerboClient } from "./client.js";
+export declare const usageToolDefinitions: {
+    readonly verbo_usage: {
+        readonly description: "Get usage statistics for the current billing period. Shows messages sent, conversations handled, AI calls made, and remaining quota.";
+        readonly schema: {};
+    };
+};
+export type UsageToolName = keyof typeof usageToolDefinitions;
+export declare function executeUsageTool(client: VerboClient, name: string, _args: Record<string, unknown>): Promise<string>;

package/dist/usage-tools.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usageToolDefinitions = void 0;
+exports.executeUsageTool = executeUsageTool;
+exports.usageToolDefinitions = {
+    verbo_usage: {
+        description: "Get usage statistics for the current billing period. Shows messages sent, conversations handled, AI calls made, and remaining quota.",
+        schema: {},
+    },
+};
+async function executeUsageTool(client, name, _args) {
+    switch (name) {
+        case "verbo_usage": {
+            const result = await client.getUsage();
+            return JSON.stringify(result, null, 2);
+        }
+        default:
+            return JSON.stringify({ error: `Unknown usage tool: ${name}` });
+    }
+}
+//# sourceMappingURL=usage-tools.js.map

package/dist/usage-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tools.js","sourceRoot":"","sources":["../src/usage-tools.ts"],"names":[],"mappings":";;;AAaA,4CAaC;AAvBY,QAAA,oBAAoB,GAAG;IAClC,WAAW,EAAE;QACX,WAAW,EACT,sIAAsI;QACxI,MAAM,EAAE,EAAE;KACX;CACO,CAAC;AAIJ,KAAK,UAAU,gBAAgB,CACpC,MAAmB,EACnB,IAAY,EACZ,KAA8B;IAE9B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QACD;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,IAAI,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/webhook-tools.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { type VerboClient } from "./client.js";
+export declare const webhookToolDefinitions: {
+    readonly verbo_webhook_register: {
+        readonly description: "Register a webhook URL to receive real-time events from Verbo. Supported events: message.received, message.sent, conversation.opened, escalation.created.";
+        readonly schema: {
+            readonly url: z.ZodString;
+            readonly events: z.ZodArray<z.ZodString>;
+        };
+    };
+    readonly verbo_webhook_list: {
+        readonly description: "List all registered webhooks. Shows URLs, subscribed events, and IDs.";
+        readonly schema: {};
+    };
+    readonly verbo_webhook_delete: {
+        readonly description: "Delete a registered webhook by its ID. Use verbo_webhook_list to find the ID.";
+        readonly schema: {
+            readonly id: z.ZodString;
+        };
+    };
+};
+export type WebhookToolName = keyof typeof webhookToolDefinitions;
+export declare function executeWebhookTool(client: VerboClient, name: string, args: Record<string, unknown>): Promise<string>;

package/dist/webhook-tools.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webhookToolDefinitions = void 0;
+exports.executeWebhookTool = executeWebhookTool;
+// packages/mcp-server/src/webhook-tools.ts
+const zod_1 = require("zod");
+exports.webhookToolDefinitions = {
+    verbo_webhook_register: {
+        description: "Register a webhook URL to receive real-time events from Verbo. Supported events: message.received, message.sent, conversation.opened, escalation.created.",
+        schema: {
+            url: zod_1.z.string().describe("HTTPS URL to receive webhook POST requests"),
+            events: zod_1.z
+                .array(zod_1.z.string())
+                .describe("List of events to subscribe to (e.g. ['message.received', 'conversation.opened'])"),
+        },
+    },
+    verbo_webhook_list: {
+        description: "List all registered webhooks. Shows URLs, subscribed events, and IDs.",
+        schema: {},
+    },
+    verbo_webhook_delete: {
+        description: "Delete a registered webhook by its ID. Use verbo_webhook_list to find the ID.",
+        schema: {
+            id: zod_1.z.string().describe("ID of the webhook to delete"),
+        },
+    },
+};
+async function executeWebhookTool(client, name, args) {
+    switch (name) {
+        case "verbo_webhook_register": {
+            const result = await client.webhookRegister(args.url, args.events);
+            return JSON.stringify(result, null, 2) +
+                "\n\n→ Webhook registered. Verbo will POST events to your URL. Use verbo_webhook_list to see all webhooks.";
+        }
+        case "verbo_webhook_list": {
+            const result = await client.webhookList();
+            return JSON.stringify(result, null, 2) +
+                "\n\n→ Use verbo_webhook_delete with an ID to remove a webhook.";
+        }
+        case "verbo_webhook_delete": {
+            const result = await client.webhookDelete(args.id);
+            return JSON.stringify(result, null, 2) +
+                "\n\n→ Webhook deleted. No more events will be sent to that URL.";
+        }
+        default:
+            return JSON.stringify({ error: `Unknown webhook tool: ${name}` });
+    }
+}
+//# sourceMappingURL=webhook-tools.js.map

package/dist/webhook-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-tools.js","sourceRoot":"","sources":["../src/webhook-tools.ts"],"names":[],"mappings":";;;AAiCA,gDA2BC;AA5DD,2CAA2C;AAC3C,6BAAwB;AAGX,QAAA,sBAAsB,GAAG;IACpC,sBAAsB,EAAE;QACtB,WAAW,EACT,2JAA2J;QAC7J,MAAM,EAAE;YACN,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACtE,MAAM,EAAE,OAAC;iBACN,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CACP,mFAAmF,CACpF;SACJ;KACF;IACD,kBAAkB,EAAE;QAClB,WAAW,EACT,uEAAuE;QACzE,MAAM,EAAE,EAAE;KACX;IACD,oBAAoB,EAAE;QACpB,WAAW,EACT,+EAA+E;QACjF,MAAM,EAAE;YACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;SACvD;KACF;CACO,CAAC;AAIJ,KAAK,UAAU,kBAAkB,CACtC,MAAmB,EACnB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CACzC,IAAI,CAAC,GAAa,EAClB,IAAI,CAAC,MAAkB,CACxB,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,2GAA2G,CAAC;QAChH,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,gEAAgE,CAAC;QACrE,CAAC;QACD,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,iEAAiE,CAAC;QACtE,CAAC;QACD;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,yBAAyB,IAAI,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "verbo-mcp-server",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "description": "Verbo MCP Server — AI WhatsApp agent for developers",
   "bin": {
     "verbo-mcp": "./dist/index.js"

package/src/client.ts

@@ -6,55 +6,26 @@ export class VerboClient {
 
   constructor(apiKey: string, baseUrl?: string) {
     this.apiKey = apiKey;
-    this.baseUrl = (baseUrl || "https://www.verbolab.co").replace(/\/$/, "");
+    this.baseUrl = (baseUrl || "https://verbolab.co").replace(/\/$/, "");
   }
 
   private async request(path: string, options: RequestInit = {}): Promise<unknown> {
     const url = `${this.baseUrl}/api/v1${path}`;
-    let res: Response;
-    try {
-      res = await fetch(url, {
-        ...options,
-        headers: {
-          "Authorization": `Bearer ${this.apiKey}`,
-          "Content-Type": "application/json",
-          ...options.headers,
-        },
-      });
-    } catch (err) {
-      throw new Error(
-        `Could not connect to Verbo API at ${this.baseUrl}. Check your internet connection or VERBO_API_URL setting.`
-      );
-    }
+    const res = await fetch(url, {
+      ...options,
+      headers: {
+        "Authorization": `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        ...options.headers,
+      },
+    });
 
-    let data: unknown;
-    try {
-      data = await res.json();
-    } catch {
+    const data = await res.json();
+    if (!res.ok) {
       throw new Error(
-        `Verbo API returned invalid response (HTTP ${res.status}). The server may be temporarily unavailable — try again in a moment.`
+        `Verbo API error (${res.status}): ${(data as { error?: string }).error || "Unknown error"}`
       );
     }
-
-    if (!res.ok) {
-      const errorMsg = (data as { error?: string }).error || "Unknown error";
-      if (res.status === 401) {
-        throw new Error(
-          `API key is invalid or revoked. Create a new key at ${this.baseUrl}/developers`
-        );
-      }
-      if (res.status === 403) {
-        throw new Error(
-          `Subscription expired or inactive. Upgrade at ${this.baseUrl}/settings/billing — ${errorMsg}`
-        );
-      }
-      if (res.status === 429) {
-        throw new Error(
-          `Rate limit exceeded. ${errorMsg}`
-        );
-      }
-      throw new Error(`Verbo API error (${res.status}): ${errorMsg}`);
-    }
     return data;
   }
 
@@ -85,6 +56,11 @@ export class VerboClient {
     greetingMessage?: string;
     faqData?: Record<string, string>[];
     businessHours?: Record<string, unknown>;
+    agentName?: string;
+    systemInstructions?: string;
+    tone?: "professional" | "friendly" | "formal" | "casual";
+    language?: string;
+    rules?: string[];
   }) {
     return this.request("/agent/configure", {
       method: "POST",
@@ -116,4 +92,51 @@ export class VerboClient {
       body: JSON.stringify({}),
     });
   }
+
+  async knowledgeCrawl(url: string) {
+    return this.request("/knowledge/crawl", {
+      method: "POST",
+      body: JSON.stringify({ url }),
+    });
+  }
+
+  async knowledgeAdd(title: string, content: string) {
+    return this.request("/knowledge", {
+      method: "POST",
+      body: JSON.stringify({ title, content }),
+    });
+  }
+
+  async knowledgeList() {
+    return this.request("/knowledge");
+  }
+
+  async knowledgeDelete(id: string) {
+    return this.request("/knowledge", {
+      method: "DELETE",
+      body: JSON.stringify({ id }),
+    });
+  }
+
+  async webhookRegister(url: string, events: string[]) {
+    return this.request("/webhooks", {
+      method: "POST",
+      body: JSON.stringify({ url, events }),
+    });
+  }
+
+  async webhookList() {
+    return this.request("/webhooks");
+  }
+
+  async webhookDelete(id: string) {
+    return this.request("/webhooks", {
+      method: "DELETE",
+      body: JSON.stringify({ id }),
+    });
+  }
+
+  async getUsage() {
+    return this.request("/usage");
+  }
 }

package/src/index.ts

@@ -5,6 +5,9 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { VerboClient } from "./client.js";
 import { toolDefinitions, executeTool, type ToolName } from "./tools.js";
 import { setupToolDefinitions, executeSetupTool } from "./setup-tools.js";
+import { knowledgeToolDefinitions, executeKnowledgeTool } from "./knowledge-tools.js";
+import { webhookToolDefinitions, executeWebhookTool } from "./webhook-tools.js";
+import { usageToolDefinitions, executeUsageTool } from "./usage-tools.js";
 
 const apiKey = process.env.VERBO_API_KEY;
 if (!apiKey) {
@@ -15,33 +18,10 @@ if (!apiKey) {
 const baseUrl = process.env.VERBO_API_URL;
 const client = new VerboClient(apiKey, baseUrl);
 
-const server = new McpServer(
-  {
-    name: "Verbo",
-    version: "0.1.0",
-  },
-  {
-    instructions: `Verbo is an AI-powered WhatsApp customer service agent. You plug it into your product and it handles customer conversations automatically — answers questions, classifies intent, escalates complaints, follows up.
-
-## Setup workflow (run in order):
-1. verbo_setup_crawl — Crawl the business website to auto-extract name, products, FAQ, hours, tone. This configures the agent.
-2. verbo_setup_connect — Creates a WhatsApp instance. Returns a URL to scan a QR code in the browser.
-3. verbo_setup_status — Check if all steps are done. Shows what's missing.
-
-## After setup:
-- verbo_send_message — Send a WhatsApp message to any number
-- verbo_list_conversations — See recent customer conversations
-- verbo_get_conversation — Read messages in a specific conversation
-- verbo_agent_status — Check WhatsApp connection and business config
-- verbo_configure_agent — Update greeting, FAQ, or business hours
-- verbo_setup_disconnect — Disconnect WhatsApp when done
-
-## Important:
-- Do NOT search the web for information about Verbo. Everything you need is in these tools.
-- The crawl step takes 15-30 seconds. This is normal — it fetches multiple pages and uses AI extraction.
-- After connecting WhatsApp, the agent starts responding to incoming messages automatically.`,
-  },
-);
+const server = new McpServer({
+  name: "Verbo",
+  version: "0.1.0",
+});
 
 for (const [name, tool] of Object.entries(toolDefinitions)) {
   server.tool(name, tool.description, tool.schema, async (args: Record<string, unknown>) => {
@@ -79,6 +59,54 @@ for (const [name, tool] of Object.entries(setupToolDefinitions)) {
   });
 }
 
+for (const [name, tool] of Object.entries(knowledgeToolDefinitions)) {
+  server.tool(name, tool.description, tool.schema, async (args: Record<string, unknown>) => {
+    try {
+      const result = await executeKnowledgeTool(client, name, args);
+      return { content: [{ type: "text" as const, text: result }] };
+    } catch (err) {
+      const message =
+        err instanceof Error ? err.message : "Unknown error";
+      return {
+        content: [{ type: "text" as const, text: `Error: ${message}` }],
+        isError: true,
+      };
+    }
+  });
+}
+
+for (const [name, tool] of Object.entries(webhookToolDefinitions)) {
+  server.tool(name, tool.description, tool.schema, async (args: Record<string, unknown>) => {
+    try {
+      const result = await executeWebhookTool(client, name, args);
+      return { content: [{ type: "text" as const, text: result }] };
+    } catch (err) {
+      const message =
+        err instanceof Error ? err.message : "Unknown error";
+      return {
+        content: [{ type: "text" as const, text: `Error: ${message}` }],
+        isError: true,
+      };
+    }
+  });
+}
+
+for (const [name, tool] of Object.entries(usageToolDefinitions)) {
+  server.tool(name, tool.description, tool.schema, async (args: Record<string, unknown>) => {
+    try {
+      const result = await executeUsageTool(client, name, args);
+      return { content: [{ type: "text" as const, text: result }] };
+    } catch (err) {
+      const message =
+        err instanceof Error ? err.message : "Unknown error";
+      return {
+        content: [{ type: "text" as const, text: `Error: ${message}` }],
+        isError: true,
+      };
+    }
+  });
+}
+
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/src/knowledge-tools.ts

@@ -0,0 +1,69 @@
+// packages/mcp-server/src/knowledge-tools.ts
+import { z } from "zod";
+import { type VerboClient } from "./client.js";
+
+export const knowledgeToolDefinitions = {
+  verbo_knowledge_crawl: {
+    description:
+      "Crawl a URL and add the extracted content to the agent's knowledge base. Use this to teach the agent about specific pages, documentation, or product details beyond the initial setup crawl. Rate limited to 3 calls per 10 minutes.",
+    schema: {
+      url: z.string().describe("URL to crawl and extract content from"),
+    },
+  },
+  verbo_knowledge_add: {
+    description:
+      "Manually add a knowledge entry to the agent's knowledge base. Use this to add custom FAQs, policies, product details, or any structured information the agent should know.",
+    schema: {
+      title: z.string().describe("Title or topic of the knowledge entry"),
+      content: z.string().describe("Full content of the knowledge entry"),
+    },
+  },
+  verbo_knowledge_list: {
+    description:
+      "List all entries in the agent's knowledge base. Shows titles and IDs of all stored knowledge.",
+    schema: {},
+  },
+  verbo_knowledge_delete: {
+    description:
+      "Delete a knowledge entry from the agent's knowledge base by its ID. Use verbo_knowledge_list to find the ID.",
+    schema: {
+      id: z.string().describe("ID of the knowledge entry to delete"),
+    },
+  },
+} as const;
+
+export type KnowledgeToolName = keyof typeof knowledgeToolDefinitions;
+
+export async function executeKnowledgeTool(
+  client: VerboClient,
+  name: string,
+  args: Record<string, unknown>,
+): Promise<string> {
+  switch (name) {
+    case "verbo_knowledge_crawl": {
+      const result = await client.knowledgeCrawl(args.url as string);
+      return JSON.stringify(result, null, 2) +
+        "\n\n→ Content extracted and added to knowledge base. Use verbo_knowledge_list to see all entries.";
+    }
+    case "verbo_knowledge_add": {
+      const result = await client.knowledgeAdd(
+        args.title as string,
+        args.content as string,
+      );
+      return JSON.stringify(result, null, 2) +
+        "\n\n→ Knowledge entry added. Use verbo_knowledge_list to see all entries.";
+    }
+    case "verbo_knowledge_list": {
+      const result = await client.knowledgeList();
+      return JSON.stringify(result, null, 2) +
+        "\n\n→ Use verbo_knowledge_delete with an ID to remove an entry.";
+    }
+    case "verbo_knowledge_delete": {
+      const result = await client.knowledgeDelete(args.id as string);
+      return JSON.stringify(result, null, 2) +
+        "\n\n→ Knowledge entry deleted.";
+    }
+    default:
+      return JSON.stringify({ error: `Unknown knowledge tool: ${name}` });
+  }
+}

package/src/setup-tools.ts

@@ -36,40 +36,20 @@ export async function executeSetupTool(
 ): Promise<string> {
   switch (name) {
     case "verbo_setup_crawl": {
-      try {
-        const result = await client.setupCrawl(args.url as string);
-        return JSON.stringify(result, null, 2) +
-          "\n\n→ Business configured from website. Next: run verbo_setup_connect to connect WhatsApp.";
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (msg.includes("422") || msg.includes("enough content") || msg.includes("SPA")) {
-          return `Crawl failed: the website appears to be a Single Page App (React, Vue, Angular) that renders via JavaScript. The crawler can only read server-rendered HTML.\n\n→ Use verbo_configure_agent instead to set up the agent manually. Ask the user about their business and set greeting_message, faq (array of {question, answer}), and business_hours.`;
-        }
-        throw err;
-      }
+      const result = await client.setupCrawl(args.url as string);
+      return JSON.stringify(result, null, 2);
     }
     case "verbo_setup_connect": {
       const result = await client.setupConnect();
-      const data = result as Record<string, unknown>;
-      const connectUrl = data.connectUrl || "";
-      return JSON.stringify(result, null, 2) +
-        `\n\n→ WhatsApp instance created. IMPORTANT: Tell the user to open ${connectUrl} in their browser and scan the QR code with their phone. After scanning, run verbo_setup_status to confirm the connection.`;
+      return JSON.stringify(result, null, 2);
     }
     case "verbo_setup_status": {
       const result = await client.setupStatus();
-      const data = result as Record<string, unknown>;
-      const ready = data.ready;
-      if (ready) {
-        return JSON.stringify(result, null, 2) +
-          "\n\n→ All set! The AI agent is live and will respond to incoming WhatsApp messages automatically. Use verbo_send_message to send a test message.";
-      }
-      return JSON.stringify(result, null, 2) +
-        "\n\n→ Setup incomplete. Check the steps above and run the missing ones.";
+      return JSON.stringify(result, null, 2);
     }
     case "verbo_setup_disconnect": {
       const result = await client.setupDisconnect();
-      return JSON.stringify(result, null, 2) +
-        "\n\n→ WhatsApp disconnected. The phone number is free to use elsewhere.";
+      return JSON.stringify(result, null, 2);
     }
     default:
       return JSON.stringify({ error: `Unknown setup tool: ${name}` });

package/src/tools.ts

@@ -45,27 +45,47 @@ export const toolDefinitions = {
   },
   verbo_configure_agent: {
     description:
-      "Configure the AI agent behavior. Use this to manually set up the agent when verbo_setup_crawl can't extract info (e.g. SPA sites). You can set any combination of greeting, FAQ, and hours.",
+      "Configure the AI agent behavior. Set greeting message, FAQ, business hours, agent name, system instructions, tone, language, and custom rules.",
     schema: {
       greeting_message: z
         .string()
         .optional()
-        .describe("Greeting message the AI sends to new customers on WhatsApp (e.g. 'Olá! Bem-vindo à Scinti. Como posso ajudar?')"),
+        .describe("Greeting message for new customers"),
       faq: z
         .array(
           z.object({
-            question: z.string().describe("A question customers commonly ask"),
-            answer: z.string().describe("The answer the AI should give"),
+            question: z.string(),
+            answer: z.string(),
           }),
         )
         .optional()
-        .describe("List of FAQ entries the AI uses to answer customer questions"),
+        .describe("Frequently asked questions"),
       business_hours: z
         .record(z.string(), z.string())
         .optional()
         .describe(
-          "Business hours per weekday (e.g. { monday: '9:00-18:00', saturday: '9:00-13:00' })",
+          "Business hours (e.g. { monday: '9:00-18:00' })",
         ),
+      agent_name: z
+        .string()
+        .optional()
+        .describe("Display name for the AI agent (e.g. 'Sofia', 'Assistente Verbo')"),
+      system_instructions: z
+        .string()
+        .optional()
+        .describe("Custom system instructions that define how the agent behaves and responds"),
+      tone: z
+        .enum(["professional", "friendly", "formal", "casual"])
+        .optional()
+        .describe("Tone of voice for the agent's responses"),
+      language: z
+        .string()
+        .optional()
+        .describe("Primary language for responses (e.g. 'pt-BR', 'en-US', 'es')"),
+      rules: z
+        .array(z.string())
+        .optional()
+        .describe("List of custom rules the agent must follow (e.g. 'Never mention competitors')"),
     },
   },
 } as const;
@@ -84,16 +104,14 @@ export async function executeTool(
         args.message as string,
         args.image_url as string | undefined,
       );
-      return JSON.stringify(result, null, 2) +
-        "\n\n→ Message sent. Use verbo_list_conversations to see the conversation.";
+      return JSON.stringify(result, null, 2);
     }
     case "verbo_list_conversations": {
       const result = await client.listConversations({
         status: args.status as string | undefined,
         limit: args.limit as number | undefined,
       });
-      return JSON.stringify(result, null, 2) +
-        "\n\n→ Use verbo_get_conversation with a conversation ID to see full messages.";
+      return JSON.stringify(result, null, 2);
     }
     case "verbo_get_conversation": {
       const result = await client.getConversation(
@@ -112,9 +130,13 @@ export async function executeTool(
         businessHours: args.business_hours as
           | Record<string, unknown>
           | undefined,
+        agentName: args.agent_name as string | undefined,
+        systemInstructions: args.system_instructions as string | undefined,
+        tone: args.tone as "professional" | "friendly" | "formal" | "casual" | undefined,
+        language: args.language as string | undefined,
+        rules: args.rules as string[] | undefined,
       });
-      return JSON.stringify(result, null, 2) +
-        "\n\n→ Agent updated. Use verbo_setup_status to verify the full setup.";
+      return JSON.stringify(result, null, 2);
     }
     default:
       return JSON.stringify({ error: `Unknown tool: ${name}` });

package/src/usage-tools.ts

@@ -0,0 +1,27 @@
+// packages/mcp-server/src/usage-tools.ts
+import { type VerboClient } from "./client.js";
+
+export const usageToolDefinitions = {
+  verbo_usage: {
+    description:
+      "Get usage statistics for the current billing period. Shows messages sent, conversations handled, AI calls made, and remaining quota.",
+    schema: {},
+  },
+} as const;
+
+export type UsageToolName = keyof typeof usageToolDefinitions;
+
+export async function executeUsageTool(
+  client: VerboClient,
+  name: string,
+  _args: Record<string, unknown>,
+): Promise<string> {
+  switch (name) {
+    case "verbo_usage": {
+      const result = await client.getUsage();
+      return JSON.stringify(result, null, 2);
+    }
+    default:
+      return JSON.stringify({ error: `Unknown usage tool: ${name}` });
+  }
+}

package/src/webhook-tools.ts

@@ -0,0 +1,61 @@
+// packages/mcp-server/src/webhook-tools.ts
+import { z } from "zod";
+import { type VerboClient } from "./client.js";
+
+export const webhookToolDefinitions = {
+  verbo_webhook_register: {
+    description:
+      "Register a webhook URL to receive real-time events from Verbo. Supported events: message.received, message.sent, conversation.opened, escalation.created.",
+    schema: {
+      url: z.string().describe("HTTPS URL to receive webhook POST requests"),
+      events: z
+        .array(z.string())
+        .describe(
+          "List of events to subscribe to (e.g. ['message.received', 'conversation.opened'])",
+        ),
+    },
+  },
+  verbo_webhook_list: {
+    description:
+      "List all registered webhooks. Shows URLs, subscribed events, and IDs.",
+    schema: {},
+  },
+  verbo_webhook_delete: {
+    description:
+      "Delete a registered webhook by its ID. Use verbo_webhook_list to find the ID.",
+    schema: {
+      id: z.string().describe("ID of the webhook to delete"),
+    },
+  },
+} as const;
+
+export type WebhookToolName = keyof typeof webhookToolDefinitions;
+
+export async function executeWebhookTool(
+  client: VerboClient,
+  name: string,
+  args: Record<string, unknown>,
+): Promise<string> {
+  switch (name) {
+    case "verbo_webhook_register": {
+      const result = await client.webhookRegister(
+        args.url as string,
+        args.events as string[],
+      );
+      return JSON.stringify(result, null, 2) +
+        "\n\n→ Webhook registered. Verbo will POST events to your URL. Use verbo_webhook_list to see all webhooks.";
+    }
+    case "verbo_webhook_list": {
+      const result = await client.webhookList();
+      return JSON.stringify(result, null, 2) +
+        "\n\n→ Use verbo_webhook_delete with an ID to remove a webhook.";
+    }
+    case "verbo_webhook_delete": {
+      const result = await client.webhookDelete(args.id as string);
+      return JSON.stringify(result, null, 2) +
+        "\n\n→ Webhook deleted. No more events will be sent to that URL.";
+    }
+    default:
+      return JSON.stringify({ error: `Unknown webhook tool: ${name}` });
+  }
+}