@botuyo/mcp 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# @botuyo/mcp — BotUyo MCP Server
+
+Create and manage BotUyo AI agents directly from your AI coding tools — **no cloning, no building**.
+
+[![npm version](https://img.shields.io/npm/v/@botuyo/mcp.svg)](https://www.npmjs.com/package/@botuyo/mcp)
+
+## Quickstart
+
+### 1. Get your API Key
+
+Go to [admin.botuyo.com](https://admin.botuyo.com) → your tenant → **Settings → API Keys** and copy your `pk_live_...` key.
+
+### 2. Add to your MCP client
+
+The config is the same for **all MCP-compatible tools**:
+
+```json
+{
+  "mcpServers": {
+    "botuyo": {
+      "command": "npx",
+      "args": ["-y", "@botuyo/mcp"],
+      "env": {
+        "BOTUYO_API_KEY": "pk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+**Where to put this config:**
+
+| Tool | Config file |
+|---|---|
+| **Antigravity (VS Code)** | VS Code settings → MCP → Add server |
+| **Claude Desktop** | `~/.config/claude/claude_desktop_config.json` |
+| **Cursor** | `.cursor/mcp.json` in your project |
+| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
+| **Continue** | `.continue/config.json` |
+
+### 3. Start building agents
+
+Once connected, ask your AI assistant things like:
+
+> *"Create a new agent called 'Soporte' for my tenant"*
+> *"Update Mar's objective to focus on sales"*
+> *"Add a welcomeStage that greets guests in Spanish"*
+> *"Enable the EscalateToHuman and SearchKnowledgeBase tools on Mar"*
+> *"Publish the agent"*
+
+## Available Tools
+
+| Tool | Description | Role Required |
+|---|---|---|
+| `list_agents` | List all agents | viewer+ |
+| `get_agent` | Get full agent config | viewer+ |
+| `get_agent_status` | Channel status + admin link | viewer+ |
+| `create_agent` | Create a new agent | developer+ |
+| `update_agent` | Update identity (tone, language, etc.) | developer+ |
+| `upsert_stage` | Create/edit a conversation stage | developer+ |
+| `list_available_tools` | List tools available to your tenant | viewer+ |
+| `update_enabled_tools` | Enable/disable tools on an agent | developer+ |
+| `publish_agent` | Publish or unpublish an agent | developer+ |
+
+## Roles
+
+| Role | Read | Write | Publish |
+|---|---|---|---|
+| `owner` | ✅ | ✅ | ✅ |
+| `admin` | ✅ | ✅ | ✅ |
+| `developer` | ✅ | ✅ | ✅ |
+| `viewer` | ✅ | ❌ | ❌ |
+
+## Channel Integrations
+
+Connecting channels (WhatsApp, Instagram, Telegram, Web) must be done from [admin.botuyo.com](https://admin.botuyo.com) — they require interactive flows (QR scans, OAuth, etc.).
+
+Use `get_agent_status` to check which channels are connected. It returns a direct link to the admin panel for any missing channel.
+
+## Build from source
+
+```sh
+cd packages/mcp
+npm install
+npm run build
+```
+
+## Test with MCP Inspector
+
+```sh
+cd packages/mcp
+BOTUYO_API_KEY=pk_live_... npm run inspect
+```

package/dist/client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * BotuyoApiClient - Thin HTTP wrapper around the BotUyo REST API
+ * All MCP tools go through this client.
+ */
+export interface BotuyoClientConfig {
+    apiUrl: string;
+    apiKey: string;
+}
+export interface AuthResult {
+    token: string;
+    tenantId: string;
+    tenantName: string;
+    role: string;
+    canWrite: boolean;
+    channels: Array<{
+        type: string;
+        status: string;
+    }>;
+    adminPanelUrl: string;
+}
+export declare class BotuyoApiClient {
+    private config;
+    private token;
+    private authResult;
+    private tokenExpiresAt;
+    constructor(config: BotuyoClientConfig);
+    /** Exchange API key for a JWT and cache it for 55 minutes */
+    authenticate(): Promise<AuthResult>;
+    /** Make an authenticated GET request */
+    get<T = any>(path: string): Promise<T>;
+    /** Make an authenticated POST request */
+    post<T = any>(path: string, data: unknown): Promise<T>;
+    /** Make an authenticated PUT request */
+    put<T = any>(path: string, data: unknown): Promise<T>;
+    private parseJson;
+}

package/dist/client.js

@@ -0,0 +1,84 @@
+/**
+ * BotuyoApiClient - Thin HTTP wrapper around the BotUyo REST API
+ * All MCP tools go through this client.
+ */
+import fetch from 'node-fetch';
+export class BotuyoApiClient {
+    config;
+    token = null;
+    authResult = null;
+    tokenExpiresAt = 0;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Exchange API key for a JWT and cache it for 55 minutes */
+    async authenticate() {
+        const now = Date.now();
+        if (this.token && this.authResult && now < this.tokenExpiresAt) {
+            return this.authResult;
+        }
+        const res = await fetch(`${this.config.apiUrl}/api/v1/mcp/auth`, {
+            method: 'POST',
+            headers: {
+                'x-api-key': this.config.apiKey,
+                'Content-Type': 'application/json'
+            }
+        });
+        const body = await this.parseJson(res);
+        if (!body.success) {
+            throw new Error(`Authentication failed: ${body.error || 'Unknown error'}`);
+        }
+        this.token = body.data.token;
+        this.authResult = body.data;
+        this.tokenExpiresAt = now + 55 * 60 * 1000; // 55 min (token expires in 1h)
+        return this.authResult;
+    }
+    /** Make an authenticated GET request */
+    async get(path) {
+        await this.authenticate();
+        const res = await fetch(`${this.config.apiUrl}${path}`, {
+            headers: { Authorization: `Bearer ${this.token}` }
+        });
+        return this.parseJson(res);
+    }
+    /** Make an authenticated POST request */
+    async post(path, data) {
+        await this.authenticate();
+        const res = await fetch(`${this.config.apiUrl}${path}`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(data)
+        });
+        return this.parseJson(res);
+    }
+    /** Make an authenticated PUT request */
+    async put(path, data) {
+        await this.authenticate();
+        const res = await fetch(`${this.config.apiUrl}${path}`, {
+            method: 'PUT',
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(data)
+        });
+        return this.parseJson(res);
+    }
+    async parseJson(res) {
+        const text = await res.text();
+        try {
+            const json = JSON.parse(text);
+            if (!res.ok && !json.success) {
+                throw new Error(json.error || `HTTP ${res.status}`);
+            }
+            return json;
+        }
+        catch (e) {
+            throw new Error(`HTTP ${res.status}: ${text.slice(0, 200)}`);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * BotUyo MCP Server — Entry Point
+ *
+ * Usage (Claude Desktop / Cursor config):
+ * {
+ *   "mcpServers": {
+ *     "botuyo": {
+ *       "command": "node",
+ *       "args": ["/path/to/packages/mcp/dist/index.js"],
+ *       "env": {
+ *         "BOTUYO_API_KEY": "pk_live_...",
+ *         "BOTUYO_API_URL": "https://api.botuyo.com"  // optional, defaults to production
+ *       }
+ *     }
+ *   }
+ * }
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * BotUyo MCP Server — Entry Point
+ *
+ * Usage (Claude Desktop / Cursor config):
+ * {
+ *   "mcpServers": {
+ *     "botuyo": {
+ *       "command": "node",
+ *       "args": ["/path/to/packages/mcp/dist/index.js"],
+ *       "env": {
+ *         "BOTUYO_API_KEY": "pk_live_...",
+ *         "BOTUYO_API_URL": "https://api.botuyo.com"  // optional, defaults to production
+ *       }
+ *     }
+ *   }
+ * }
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { BotuyoApiClient } from './client.js';
+import { ALL_TOOLS, TOOL_HANDLERS } from './tools/index.js';
+// ─── Config ────────────────────────────────────────────────────────────────────
+const API_KEY = process.env.BOTUYO_API_KEY;
+const API_URL = process.env.BOTUYO_API_URL || 'https://api.botuyo.com';
+if (!API_KEY) {
+    console.error('[botuyo-mcp] Error: BOTUYO_API_KEY environment variable is required');
+    process.exit(1);
+}
+// ─── Client ────────────────────────────────────────────────────────────────────
+const client = new BotuyoApiClient({ apiKey: API_KEY, apiUrl: API_URL });
+// ─── MCP Server ────────────────────────────────────────────────────────────────
+const server = new Server({ name: 'botuyo-mcp', version: '0.1.0' }, { capabilities: { tools: {} } });
+/** List all available MCP tools */
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: ALL_TOOLS
+}));
+/** Dispatch tool calls */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const handler = TOOL_HANDLERS[name];
+    if (!handler) {
+        return {
+            content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+            isError: true
+        };
+    }
+    try {
+        const result = await handler(client, args || {});
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
+        };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error: ${msg}` }],
+            isError: true
+        };
+    }
+});
+// ─── Start ─────────────────────────────────────────────────────────────────────
+async function main() {
+    // Verify credentials on startup
+    try {
+        const auth = await client.authenticate();
+        console.error(`[botuyo-mcp] ✓ Connected to tenant "${auth.tenantName}" as ${auth.role}`);
+        if (!auth.canWrite) {
+            console.error('[botuyo-mcp] ⚠ Your role is viewer — write operations will be rejected');
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[botuyo-mcp] ✗ Auth failed: ${msg}`);
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[botuyo-mcp] Server running via stdio');
+}
+main().catch((err) => {
+    console.error('[botuyo-mcp] Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/create_agent.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const CREATE_AGENT_TOOL: Tool;
+export declare function createAgentHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;

package/dist/tools/create_agent.js

@@ -0,0 +1,21 @@
+export const CREATE_AGENT_TOOL = {
+    name: 'create_agent',
+    description: 'Create a new agent for the tenant. The agent is created in "draft" status. Use update_agent to configure identity, stages, and tools afterward. Requires role: owner, admin, or developer.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Display name of the agent (e.g. "Mar 🌊")' },
+            description: { type: 'string', description: 'Brief description of what this agent does' },
+            type: { type: 'string', description: 'Agent type. Use "agent" (default)', enum: ['agent'] }
+        },
+        required: ['name']
+    }
+};
+export async function createAgentHandler(client, args) {
+    return client.post('/api/v1/mcp/agents', {
+        name: args.name,
+        description: args.description || '',
+        type: args.type || 'agent'
+    });
+}
+//# sourceMappingURL=create_agent.js.map

package/dist/tools/create_agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_agent.js","sourceRoot":"","sources":["../../src/tools/create_agent.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,4LAA4L;IACzM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YAClF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YACzF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;SAC5F;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAuB,EAAE,IAA6B;IAC7F,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO;KAC3B,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/get_agent.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const GET_AGENT_TOOL: Tool;
+export declare function getAgentHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;

package/dist/tools/get_agent.js

@@ -0,0 +1,16 @@
+export const GET_AGENT_TOOL = {
+    name: 'get_agent',
+    description: 'Get the full configuration of a specific agent, including identity (tone, language, objective, customInstructions), stages, and enabled tools.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: { type: 'string', description: 'The MongoDB ID of the agent' }
+        },
+        required: ['agentId']
+    }
+};
+export async function getAgentHandler(client, args) {
+    const agentId = args.agentId;
+    return client.get(`/api/v1/mcp/agents/${agentId}`);
+}
+//# sourceMappingURL=get_agent.js.map

package/dist/tools/get_agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_agent.js","sourceRoot":"","sources":["../../src/tools/get_agent.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,gJAAgJ;IAC7J,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACxE;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAuB,EAAE,IAA6B;IAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAA;IACtC,OAAO,MAAM,CAAC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/tools/get_agent_status.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const GET_AGENT_STATUS_TOOL: Tool;
+export declare function getAgentStatusHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;

package/dist/tools/get_agent_status.js

@@ -0,0 +1,16 @@
+export const GET_AGENT_STATUS_TOOL = {
+    name: 'get_agent_status',
+    description: 'Get the channel connection status of an agent (WhatsApp, Instagram, Telegram, Web). Shows which channels are connected and provides a direct link to the admin panel to connect missing channels.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: { type: 'string', description: 'The MongoDB ID of the agent' }
+        },
+        required: ['agentId']
+    }
+};
+export async function getAgentStatusHandler(client, args) {
+    const agentId = args.agentId;
+    return client.get(`/api/v1/mcp/agents/${agentId}/status`);
+}
+//# sourceMappingURL=get_agent_status.js.map

package/dist/tools/get_agent_status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_agent_status.js","sourceRoot":"","sources":["../../src/tools/get_agent_status.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,mMAAmM;IAChN,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACxE;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAuB,EAAE,IAA6B;IAChG,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAA;IACtC,OAAO,MAAM,CAAC,GAAG,CAAC,sBAAsB,OAAO,SAAS,CAAC,CAAA;AAC3D,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tools Registry — exports ALL_TOOLS and TOOL_HANDLERS
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const ALL_TOOLS: Tool[];
+export type ToolHandler = (client: BotuyoApiClient, args: Record<string, unknown>) => Promise<unknown>;
+export declare const TOOL_HANDLERS: Record<string, ToolHandler>;

package/dist/tools/index.js

@@ -0,0 +1,36 @@
+/**
+ * MCP Tools Registry — exports ALL_TOOLS and TOOL_HANDLERS
+ */
+// Import all tool definitions
+import { LIST_AGENTS_TOOL, listAgentsHandler } from './list_agents.js';
+import { GET_AGENT_TOOL, getAgentHandler } from './get_agent.js';
+import { GET_AGENT_STATUS_TOOL, getAgentStatusHandler } from './get_agent_status.js';
+import { CREATE_AGENT_TOOL, createAgentHandler } from './create_agent.js';
+import { UPDATE_AGENT_TOOL, updateAgentHandler } from './update_agent.js';
+import { UPSERT_STAGE_TOOL, upsertStageHandler } from './upsert_stage.js';
+import { LIST_TOOLS_TOOL, listToolsHandler } from './list_available_tools.js';
+import { UPDATE_ENABLED_TOOLS_TOOL, updateEnabledToolsHandler } from './update_enabled_tools.js';
+import { PUBLISH_AGENT_TOOL, publishAgentHandler } from './publish_agent.js';
+export const ALL_TOOLS = [
+    LIST_AGENTS_TOOL,
+    GET_AGENT_TOOL,
+    GET_AGENT_STATUS_TOOL,
+    CREATE_AGENT_TOOL,
+    UPDATE_AGENT_TOOL,
+    UPSERT_STAGE_TOOL,
+    LIST_TOOLS_TOOL,
+    UPDATE_ENABLED_TOOLS_TOOL,
+    PUBLISH_AGENT_TOOL,
+];
+export const TOOL_HANDLERS = {
+    list_agents: listAgentsHandler,
+    get_agent: getAgentHandler,
+    get_agent_status: getAgentStatusHandler,
+    create_agent: createAgentHandler,
+    update_agent: updateAgentHandler,
+    upsert_stage: upsertStageHandler,
+    list_available_tools: listToolsHandler,
+    update_enabled_tools: updateEnabledToolsHandler,
+    publish_agent: publishAgentHandler,
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,8BAA8B;AAC9B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAChG,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE5E,MAAM,CAAC,MAAM,SAAS,GAAW;IAC/B,gBAAgB;IAChB,cAAc;IACd,qBAAqB;IACrB,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,yBAAyB;IACzB,kBAAkB;CACnB,CAAA;AAID,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,eAAe;IAC1B,gBAAgB,EAAE,qBAAqB;IACvC,YAAY,EAAE,kBAAkB;IAChC,YAAY,EAAE,kBAAkB;IAChC,YAAY,EAAE,kBAAkB;IAChC,oBAAoB,EAAE,gBAAgB;IACtC,oBAAoB,EAAE,yBAAyB;IAC/C,aAAa,EAAE,mBAAmB;CACnC,CAAA"}

package/dist/tools/list_agents.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const LIST_AGENTS_TOOL: Tool;
+export declare function listAgentsHandler(client: BotuyoApiClient, _args: Record<string, unknown>): Promise<any>;

package/dist/tools/list_agents.js

@@ -0,0 +1,10 @@
+export const LIST_AGENTS_TOOL = {
+    name: 'list_agents',
+    description: 'Lists all agents for the authenticated tenant. Returns id, name, description, status (draft/published), and how many tools each agent has enabled.',
+    inputSchema: { type: 'object', properties: {}, required: [] }
+};
+export async function listAgentsHandler(client, _args) {
+    const res = await client.get('/api/v1/mcp/agents');
+    return res;
+}
+//# sourceMappingURL=list_agents.js.map

package/dist/tools/list_agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_agents.js","sourceRoot":"","sources":["../../src/tools/list_agents.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,oJAAoJ;IACjK,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;CAC9D,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAuB,EAAE,KAA8B;IAC7F,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IAClD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/tools/list_available_tools.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const LIST_TOOLS_TOOL: Tool;
+export declare function listToolsHandler(client: BotuyoApiClient, _args: Record<string, unknown>): Promise<any>;

package/dist/tools/list_available_tools.js

@@ -0,0 +1,9 @@
+export const LIST_TOOLS_TOOL = {
+    name: 'list_available_tools',
+    description: 'List all tools available for this tenant. Returns both "core" tools (available to all tenants) and "tenant" tools (custom tools specific to your tenant). Use tool IDs when enabling tools with update_enabled_tools or configuring stage tools.',
+    inputSchema: { type: 'object', properties: {}, required: [] }
+};
+export async function listToolsHandler(client, _args) {
+    return client.get('/api/v1/mcp/tools');
+}
+//# sourceMappingURL=list_available_tools.js.map

package/dist/tools/list_available_tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_available_tools.js","sourceRoot":"","sources":["../../src/tools/list_available_tools.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,kPAAkP;IAC/P,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;CAC9D,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAuB,EAAE,KAA8B;IAC5F,OAAO,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;AACxC,CAAC"}

package/dist/tools/publish_agent.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const PUBLISH_AGENT_TOOL: Tool;
+export declare function publishAgentHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;

package/dist/tools/publish_agent.js

@@ -0,0 +1,17 @@
+export const PUBLISH_AGENT_TOOL = {
+    name: 'publish_agent',
+    description: 'Publish or unpublish an agent. Published agents are live and handle incoming conversations. Unpublished agents are in "draft" status.\n\nRequires role: owner, admin, or developer.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: { type: 'string', description: 'The MongoDB ID of the agent' },
+            publish: { type: 'boolean', description: 'true = publish (go live), false = unpublish (back to draft)' }
+        },
+        required: ['agentId', 'publish']
+    }
+};
+export async function publishAgentHandler(client, args) {
+    const { agentId, publish } = args;
+    return client.put(`/api/v1/mcp/agents/${agentId}/publish`, { publish });
+}
+//# sourceMappingURL=publish_agent.js.map

package/dist/tools/publish_agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish_agent.js","sourceRoot":"","sources":["../../src/tools/publish_agent.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,qLAAqL;IAClM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACvE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6DAA6D,EAAE;SACzG;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;KACjC;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAuB,EAAE,IAA6B;IAC9F,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IACjC,OAAO,MAAM,CAAC,GAAG,CAAC,sBAAsB,OAAiB,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;AACnF,CAAC"}

package/dist/tools/update_agent.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const UPDATE_AGENT_TOOL: Tool;
+export declare function updateAgentHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;

package/dist/tools/update_agent.js

@@ -0,0 +1,33 @@
+export const UPDATE_AGENT_TOOL = {
+    name: 'update_agent',
+    description: `Update an agent's identity configuration (tone, language, objective, custom instructions) and/or top-level name/description. 
+  
+Use this to configure WHO the agent is. For defining WHAT the agent does in each conversation flow, use upsert_stage.
+For changing which tools the agent can call, use update_enabled_tools.
+
+Requires role: owner, admin, or developer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: { type: 'string', description: 'The MongoDB ID of the agent' },
+            name: { type: 'string', description: 'Agent display name' },
+            description: { type: 'string', description: 'Agent description' },
+            identity: {
+                type: 'object',
+                description: 'Identity configuration for the agent',
+                properties: {
+                    tone: { type: 'string', description: 'Personality tone (e.g. "Cálida, experta, persuasiva con FOMO natural")' },
+                    language: { type: 'string', description: 'BCP-47 language code (e.g. "es-AR", "en-US", "pt-BR")' },
+                    objective: { type: 'string', description: 'Primary objective of the agent' },
+                    customInstructions: { type: 'string', description: 'Custom instructions that override default behavior. Supports markdown.' }
+                }
+            }
+        },
+        required: ['agentId']
+    }
+};
+export async function updateAgentHandler(client, args) {
+    const { agentId, ...rest } = args;
+    return client.put(`/api/v1/mcp/agents/${agentId}`, rest);
+}
+//# sourceMappingURL=update_agent.js.map

package/dist/tools/update_agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_agent.js","sourceRoot":"","sources":["../../src/tools/update_agent.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;2CAK4B;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACvE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;YAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;YACjE,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;gBACnD,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wEAAwE,EAAE;oBAC/G,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;oBAClG,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;oBAC5E,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wEAAwE,EAAE;iBAC9H;aACF;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAuB,EAAE,IAA6B;IAC7F,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IACjC,OAAO,MAAM,CAAC,GAAG,CAAC,sBAAsB,OAAiB,EAAE,EAAE,IAAI,CAAC,CAAA;AACpE,CAAC"}

package/dist/tools/update_enabled_tools.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const UPDATE_ENABLED_TOOLS_TOOL: Tool;
+export declare function updateEnabledToolsHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;

package/dist/tools/update_enabled_tools.js

@@ -0,0 +1,27 @@
+export const UPDATE_ENABLED_TOOLS_TOOL = {
+    name: 'update_enabled_tools',
+    description: `Set which tools are enabled for an agent. This REPLACES the current list of enabled tools.
+
+Use list_available_tools to see the valid tool IDs for your tenant first.
+
+Requires role: owner, admin, or developer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: { type: 'string', description: 'The MongoDB ID of the agent' },
+            toolIds: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of tool IDs to enable (replaces current list). Get valid IDs from list_available_tools.'
+            }
+        },
+        required: ['agentId', 'toolIds']
+    }
+};
+export async function updateEnabledToolsHandler(client, args) {
+    const { agentId, toolIds } = args;
+    return client.put(`/api/v1/mcp/agents/${agentId}`, {
+        enabledTools: toolIds
+    });
+}
+//# sourceMappingURL=update_enabled_tools.js.map

package/dist/tools/update_enabled_tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_enabled_tools.js","sourceRoot":"","sources":["../../src/tools/update_enabled_tools.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,yBAAyB,GAAS;IAC7C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;2CAI4B;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACvE,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+FAA+F;aAC7G;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;KACjC;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,MAAuB,EAAE,IAA6B;IACpG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IACjC,OAAO,MAAM,CAAC,GAAG,CAAC,sBAAsB,OAAiB,EAAE,EAAE;QAC3D,YAAY,EAAE,OAAO;KACtB,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/upsert_stage.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const UPSERT_STAGE_TOOL: Tool;
+export declare function upsertStageHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;

package/dist/tools/upsert_stage.js

@@ -0,0 +1,39 @@
+export const UPSERT_STAGE_TOOL = {
+    name: 'upsert_stage',
+    description: `Create or update a named stage in an agent's conversation flow.
+
+A stage defines what the agent does at a particular step in the conversation.
+Each stage has a list of "actions" that the agent can take (send_message, use_tool, go_to_stage, etc.).
+
+Examples of stage names: "welcomeStage", "salesStage", "hostStage", "checkoutStage"
+
+The stage config is merged with existing stages — existing stages you don't specify are kept unchanged.
+
+Requires role: owner, admin, or developer.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: { type: 'string', description: 'The MongoDB ID of the agent' },
+            stageName: { type: 'string', description: 'Name key for this stage (e.g. "welcomeStage", "salesStage")' },
+            stageConfig: {
+                type: 'object',
+                description: 'Full stage configuration object. See BotUyo stage schema for full details.',
+                properties: {
+                    label: { type: 'string', description: 'Human-readable label for this stage' },
+                    instruction: { type: 'string', description: 'Instructions for the AI in this stage' },
+                    tools: { type: 'array', items: { type: 'string' }, description: 'Tool IDs available in this stage' },
+                    trigger: { type: 'string', description: 'Optional trigger condition' },
+                    channels: { type: 'array', items: { type: 'string' }, description: 'Channels where this stage is active' }
+                }
+            }
+        },
+        required: ['agentId', 'stageName', 'stageConfig']
+    }
+};
+export async function upsertStageHandler(client, args) {
+    const { agentId, stageName, stageConfig } = args;
+    return client.put(`/api/v1/mcp/agents/${agentId}`, {
+        stages: { [stageName]: stageConfig }
+    });
+}
+//# sourceMappingURL=upsert_stage.js.map

package/dist/tools/upsert_stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert_stage.js","sourceRoot":"","sources":["../../src/tools/upsert_stage.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;;;;;2CAS4B;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACvE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;YACzG,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4EAA4E;gBACzF,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;oBAC7E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;oBACrF,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBACpG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;oBACtE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,qCAAqC,EAAE;iBAC3G;aACF;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC;KAClD;CACF,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAuB,EAAE,IAA6B;IAC7F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAChD,OAAO,MAAM,CAAC,GAAG,CAAC,sBAAsB,OAAiB,EAAE,EAAE;QAC3D,MAAM,EAAE,EAAE,CAAC,SAAmB,CAAC,EAAE,WAAW,EAAE;KAC/C,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@botuyo/mcp",
+  "version": "0.1.0",
+  "description": "BotUyo MCP Server — create and manage AI agents via Model Context Protocol",
+  "keywords": ["mcp", "botuyo", "ai-agents", "chatbot", "model-context-protocol"],
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "botuyo-mcp": "dist/index.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0",
+    "node-fetch": "^3.3.2",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MarcoAR1/botuyo-backend.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://botuyo.com",
+  "license": "MIT"
+}