@launchpath-ai/mcp-server 1.0.0

package/build/index.js

@@ -0,0 +1,374 @@
+#!/usr/bin/env node
+/**
+ * LaunchPath MCP Server
+ *
+ * Manage AI agents, knowledge bases, deployments, clients, and campaigns
+ * from Claude Code, Claude Desktop, or any MCP-compatible client.
+ *
+ * Usage:
+ *   LAUNCHPATH_API_KEY=lp_key_xxx npx @launchpath/mcp-server
+ *   LAUNCHPATH_API_KEY=lp_key_xxx LAUNCHPATH_BASE_URL=http://localhost:3000 npx @launchpath/mcp-server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { LaunchPathClient } from "./client.js";
+// --- Tool registration imports ---
+import { registerCoreTools } from "./tools/core.js";
+import { registerAgentManagementTools } from "./tools/agents.js";
+import { registerKnowledgeTools } from "./tools/knowledge.js";
+import { registerDeploymentTools } from "./tools/channels.js";
+import { registerClientTools } from "./tools/clients.js";
+import { registerCampaignTools } from "./tools/campaigns.js";
+import { registerWhatsAppTools } from "./tools/whatsapp.js";
+import { registerAnalyticsTools } from "./tools/analytics.js";
+import { registerToolsConfigTools } from "./tools/tools-config.js";
+import { registerPortalTools } from "./tools/portal.js";
+import { registerIntegrationTools } from "./tools/integrations.js";
+// ─── Configuration ───────────────────────────────────────────────────────────
+const API_KEY = process.env.LAUNCHPATH_API_KEY;
+const BASE_URL = process.env.LAUNCHPATH_BASE_URL || "https://app.launchpath.ai";
+if (!API_KEY) {
+    console.error("Error: LAUNCHPATH_API_KEY environment variable is required.\n" +
+        "Get your API key from LaunchPath → Settings → API Keys.\n" +
+        "Set it: export LAUNCHPATH_API_KEY=lp_key_xxx");
+    process.exit(1);
+}
+const client = new LaunchPathClient({ apiKey: API_KEY, baseUrl: BASE_URL });
+// ─── Server Instructions ─────────────────────────────────────────────────────
+// Injected into the model's system prompt. Guides cross-tool behavior.
+const SERVER_INSTRUCTIONS = `LaunchPath is an AI agent deployment platform. You can create, train, deploy, and manage AI agents for businesses — entirely from the terminal.
+
+## Core Workflow
+1. **Create** an agent: use create_agent (blank) or create_agent_from_prompt (AI-generated from a description)
+2. **Train** it: use discover_pages to find all pages on a site, scrape_website to add content, generate_faqs to auto-create Q&A pairs, and add_faq for manual Q&A pairs
+3. **Add integrations**: use enable_toolset("integrations") to browse 900+ apps, then enable_toolset("tools-config") to add tools to the agent
+4. **Test** it: use chat_with_agent to send test messages — this works without deploying
+5. **Deploy** (only when the user asks): deploy to a website widget, WhatsApp, or API channel
+6. **Manage clients**: use create_client + create_campaign to assign agents to client businesses
+
+## Key Rules
+- Always call list_agents first if you need an agent_id
+- Always call list_clients first if you need a client_id
+- Use get_agent to read current config before calling update_agent
+- After making changes, use chat_with_agent to verify the agent works correctly
+- Use discover_pages before scrape_website for full-site coverage
+- After scraping, use generate_faqs to auto-create Q&A pairs, then edit_faq to refine them or add_faq for manual additions
+- Do NOT deploy unless the user explicitly asks. Testing with chat_with_agent does not require deployment.
+
+## Deploying Channels
+Only deploy when the user requests it. First call enable_toolset("deployment") to load channel tools.
+
+### Website Widget
+1. deploy_channel(agent_id, channel_type: "widget") — creates the widget
+2. configure_widget — customize colors, theme, position, avatar, welcome message, conversation starters, pre-chat form
+3. get_embed_code — get the HTML snippet to paste on a website
+
+### WhatsApp
+WhatsApp requires Meta Business credentials that must be entered in the LaunchPath dashboard (not via terminal).
+1. enable_toolset("campaigns") + enable_toolset("whatsapp")
+2. create_campaign(agent_id, client_id, channel_type: "whatsapp") — creates a campaign with a placeholder WhatsApp channel
+3. Tell the user: "Enter your Meta credentials (Phone Number ID, Access Token, Business Account ID, App Secret) at ${BASE_URL}/dashboard/campaigns/<campaign_id>"
+4. Once credentials are saved, use the whatsapp toolset: create templates → import contacts → send broadcasts or create drip sequences
+
+### API Channel
+1. deploy_channel(agent_id, channel_type: "api") — creates an API endpoint with a bearer token
+2. The response includes the public chat endpoint URL and authentication details
+3. Use this to build custom chat UIs, integrate with other apps, or connect to any platform
+
+## Adding Integrations
+When the user wants their agent to use external services (Google Calendar, Gmail, Slack, Sheets, etc.):
+
+1. Load the integrations toolset: enable_toolset("integrations")
+2. Search for the app: browse_integrations(search: "calendar")
+3. See available actions: list_app_actions(toolkit: "googlecalendar")
+4. Check if connected: check_connections()
+5. If NOT connected: tell the user to open ${BASE_URL}/dashboard/settings/integrations in their browser to connect the app. OAuth requires a browser — it cannot be done from the terminal.
+6. Once connected: load tools-config toolset, then add_agent_tool with the correct toolkit slug and action names
+7. Update the agent's tool_guidelines with usage instructions for the new tools
+
+IMPORTANT: Integrations that require OAuth (Google, Slack, GitHub, etc.) MUST be connected via the LaunchPath dashboard first. Always check connections before adding tools. If a tool is added without a connection, it will fail at runtime. Direct the user to: ${BASE_URL}/dashboard/settings/integrations
+
+## Toolset System
+By default you have access to: agent management and knowledge tools.
+All other toolsets are loaded on demand — call enable_toolset when you need them:
+- **deployment**: Deploy to widget, WhatsApp, or API channels — manage channels, appearance, embed code
+- **clients**: Manage client businesses — create clients, assign agents
+- **campaigns**: Manage client campaigns (list, create, update)
+- **whatsapp**: WhatsApp templates, broadcasts, contacts, drip sequences
+- **analytics**: Agent metrics, conversations, broadcast results, sequence performance, channel health
+- **tools-config**: Manage agent tool integrations — add, edit, enable/disable, remove (webhooks, APIs, app integrations)
+- **portal**: Client portal invites and branding
+- **integrations**: Browse 900+ app integrations, list actions, check user connections
+
+Load a toolset when the user mentions its domain (e.g., "deploy my agent" → enable_toolset("deployment"), "set up a WhatsApp campaign" → enable_toolset("campaigns") + enable_toolset("whatsapp"), "add Google Calendar" → enable_toolset("integrations"), "manage clients" → enable_toolset("clients")).
+
+When you're done with a toolset and moving to a different domain, use disable_toolset to unload it. This keeps your active tool count low, which improves response quality and reduces token overhead. For example, after finishing WhatsApp setup, call disable_toolset("whatsapp") + disable_toolset("campaigns") before starting widget deployment.
+
+## Rate Limits
+- 60 requests per minute across all tools
+- Long-running operations (scrape_website, create_agent_from_prompt) may take 10-30 seconds
+
+## Models
+- Slash-prefixed IDs use OpenRouter (e.g., "openai/gpt-4o-mini")
+- Bare IDs use direct Anthropic (e.g., "claude-sonnet-4-5-20250929")
+- Default model for new agents: "openai/gpt-4o-mini" (most cost-effective)`;
+// ─── Server Setup ────────────────────────────────────────────────────────────
+const server = new McpServer({
+    name: "launchpath",
+    version: "1.0.0",
+}, {
+    instructions: SERVER_INSTRUCTIONS,
+    capabilities: {
+        tools: {},
+    },
+});
+// ─── Track loaded toolsets ───────────────────────────────────────────────────
+const loadedToolsets = new Set(["core", "agent-management", "knowledge"]);
+const toolsetRefs = new Map();
+/**
+ * Call a register function and capture all RegisteredTool references it creates.
+ * Uses a temporary wrapper around server.registerTool to intercept return values.
+ */
+function registerAndCapture(name, registerFn) {
+    const refs = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const original = server.registerTool.bind(server);
+    // Temporarily wrap to capture each returned RegisteredTool
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    server.registerTool = (...args) => {
+        const registered = original(...args);
+        refs.push(registered);
+        return registered;
+    };
+    registerFn();
+    // Restore original
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    server.registerTool = original;
+    toolsetRefs.set(name, refs);
+}
+const availableToolsets = {
+    deployment: {
+        description: "Deploy agents to website widget, WhatsApp, or API channels — manage channels, widget appearance, and embed code",
+        isDefault: false,
+        register: () => registerDeploymentTools(server, client),
+    },
+    clients: {
+        description: "Manage client businesses — create clients, assign agents via campaigns",
+        isDefault: false,
+        register: () => registerClientTools(server, client),
+    },
+    campaigns: {
+        description: "Manage client campaigns — list, get, create, update campaigns that link agents to clients",
+        isDefault: false,
+        register: () => registerCampaignTools(server, client),
+    },
+    whatsapp: {
+        description: "WhatsApp Business tools — message templates, broadcasts, contact management, drip sequences",
+        isDefault: false,
+        register: () => registerWhatsAppTools(server, client),
+    },
+    analytics: {
+        description: "Analytics and monitoring — agent metrics, conversations, broadcast results, sequence performance, channel activity and health",
+        isDefault: false,
+        register: () => registerAnalyticsTools(server, client),
+    },
+    "tools-config": {
+        description: "Manage agent tool integrations — add, edit, enable/disable, remove webhooks, HTTP APIs, app integrations, subagents",
+        isDefault: false,
+        register: () => registerToolsConfigTools(server, client),
+    },
+    portal: {
+        description: "Client portal management — invite members, customize branding/white-label",
+        isDefault: false,
+        register: () => registerPortalTools(server, client),
+    },
+    integrations: {
+        description: "Browse 900+ app integrations (Google Calendar, Gmail, Slack, etc.), list available actions, and check which apps the user has connected",
+        isDefault: false,
+        register: () => registerIntegrationTools(server, client),
+    },
+};
+// ─── Register default tools ──────────────────────────────────────────────────
+registerAndCapture("core", () => registerCoreTools(server, client));
+registerAndCapture("agent-management", () => registerAgentManagementTools(server, client));
+registerAndCapture("knowledge", () => registerKnowledgeTools(server, client));
+// ─── enable_toolset meta tool ────────────────────────────────────────────────
+server.registerTool("enable_toolset", {
+    title: "Enable Toolset",
+    description: "Load additional tools on demand, or re-enable a previously disabled toolset. Available: deployment, clients, campaigns, whatsapp, analytics, tools-config, portal, integrations.",
+    inputSchema: {
+        toolset: z
+            .enum(["deployment", "clients", "campaigns", "whatsapp", "analytics", "tools-config", "portal", "integrations"])
+            .describe("Name of the toolset to enable"),
+    },
+}, async ({ toolset }) => {
+    // Re-enable a previously disabled toolset
+    if (loadedToolsets.has(toolset)) {
+        const refs = toolsetRefs.get(toolset);
+        const allEnabled = !refs || refs.every((r) => r.enabled);
+        if (allEnabled) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Toolset "${toolset}" is already loaded and active. You can use its tools now.`,
+                    },
+                ],
+            };
+        }
+        // Re-enable disabled tools
+        for (const ref of refs ?? [])
+            ref.enable();
+        // Fall through to show the tool list
+    }
+    else {
+        const info = availableToolsets[toolset];
+        if (!info) {
+            const available = Object.keys(availableToolsets).join(", ");
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown toolset "${toolset}". Available: ${available}`,
+                    },
+                ],
+            };
+        }
+        registerAndCapture(toolset, () => info.register());
+        loadedToolsets.add(toolset);
+    }
+    // List the newly available tools based on toolset
+    const toolNames = {
+        deployment: [
+            "list_channels",
+            "deploy_channel",
+            "delete_channel",
+            "update_channel",
+            "configure_widget",
+            "get_embed_code",
+        ],
+        clients: ["list_clients", "get_client", "create_client", "update_client"],
+        campaigns: ["list_campaigns", "get_campaign", "create_campaign", "update_campaign"],
+        whatsapp: [
+            "list_wa_templates",
+            "create_wa_template",
+            "send_wa_broadcast",
+            "list_wa_contacts",
+            "import_wa_contacts",
+            "create_wa_sequence",
+            "activate_wa_sequence",
+            "enroll_wa_contacts",
+        ],
+        analytics: [
+            "get_agent_analytics",
+            "list_conversations",
+            "get_conversation",
+            "list_send_jobs",
+            "get_sequence_stats",
+            "get_sequence_detail",
+            "get_channel_activity",
+            "get_channel_health",
+        ],
+        "tools-config": [
+            "list_agent_tools",
+            "add_agent_tool",
+            "update_agent_tool",
+            "remove_agent_tool",
+            "test_agent_tool",
+        ],
+        portal: ["invite_client_member", "update_portal_branding"],
+        integrations: ["browse_integrations", "list_app_actions", "check_connections"],
+    };
+    const tools = toolNames[toolset] ?? [];
+    let text = `Toolset "${toolset}" enabled. New tools available:\n${tools.map((t) => `  - ${t}`).join("\n")}`;
+    // Add contextual guidance per toolset
+    const toolsetHints = {
+        deployment: `\n\nUse deploy_channel to create a widget, WhatsApp, or API channel.\nFor widgets: configure_widget to customize appearance + content, then get_embed_code.\nFor WhatsApp: use enable_toolset("campaigns") + enable_toolset("whatsapp") instead.`,
+        clients: `\n\nUse list_clients to see existing clients, create_client to add new ones.\nAfter creating a client, use enable_toolset("campaigns") to create campaigns linking agents to clients.`,
+        integrations: `\n\nStart by searching for an app: browse_integrations(search: "calendar")\nThen check user connections: check_connections()`,
+        "tools-config": `\n\nUse list_agent_tools(agent_id) to see current tools on an agent.\nUse add_agent_tool to add new integrations, update_agent_tool to edit config or enable/disable.`,
+        whatsapp: `\n\nIMPORTANT: WhatsApp templates require Meta approval (1-24 hours). Create templates first, then check status before broadcasting.\nFlow: create templates → import contacts → check template status (list_wa_templates) → send broadcasts OR create sequence → activate_wa_sequence → enroll_wa_contacts.\nVariable mapping: use { "1": "name", "2": "custom_fields.company" } to personalize messages per contact.`,
+        campaigns: `\n\nA campaign links an agent to a client. Create a client first, then create a campaign.`,
+        analytics: `\n\nUse get_agent_analytics for high-level metrics, list_conversations for history (filterable by campaign_id, channel_type, status, or search).\nFor WhatsApp: list_send_jobs for broadcast delivery results, get_sequence_stats + get_sequence_detail for drip campaign performance.\nFor debugging: get_channel_activity for event logs, get_channel_health to check if a channel is working.`,
+        portal: `\n\nUse invite_client_member to give clients access to their portal. Use update_portal_branding to white-label it.`,
+    };
+    if (toolsetHints[toolset]) {
+        text += toolsetHints[toolset];
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text,
+            },
+        ],
+    };
+});
+// ─── disable_toolset meta tool ───────────────────────────────────────────────
+server.registerTool("disable_toolset", {
+    title: "Disable Toolset",
+    description: "Unload a previously enabled toolset to reduce clutter and improve performance. The tools become invisible until re-enabled with enable_toolset. Cannot disable default toolsets (core, agent-management, knowledge).",
+    inputSchema: {
+        toolset: z
+            .enum(["deployment", "clients", "campaigns", "whatsapp", "analytics", "tools-config", "portal", "integrations"])
+            .describe("Name of the toolset to disable"),
+    },
+}, async ({ toolset }) => {
+    const refs = toolsetRefs.get(toolset);
+    if (!refs || !loadedToolsets.has(toolset)) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Toolset "${toolset}" is not currently loaded. Nothing to disable.`,
+                },
+            ],
+        };
+    }
+    const alreadyDisabled = refs.every((r) => !r.enabled);
+    if (alreadyDisabled) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Toolset "${toolset}" is already disabled.`,
+                },
+            ],
+        };
+    }
+    for (const ref of refs)
+        ref.disable();
+    const toolNames = {
+        deployment: ["list_channels", "deploy_channel", "delete_channel", "update_channel", "configure_widget", "get_embed_code"],
+        clients: ["list_clients", "get_client", "create_client", "update_client"],
+        campaigns: ["list_campaigns", "get_campaign", "create_campaign", "update_campaign"],
+        whatsapp: ["list_wa_templates", "create_wa_template", "send_wa_broadcast", "list_wa_contacts", "import_wa_contacts", "create_wa_sequence", "activate_wa_sequence", "enroll_wa_contacts"],
+        analytics: ["get_agent_analytics", "list_conversations", "get_conversation", "list_send_jobs", "get_sequence_stats", "get_sequence_detail", "get_channel_activity", "get_channel_health"],
+        "tools-config": ["list_agent_tools", "add_agent_tool", "update_agent_tool", "remove_agent_tool", "test_agent_tool"],
+        portal: ["invite_client_member", "update_portal_branding"],
+        integrations: ["browse_integrations", "list_app_actions", "check_connections"],
+    };
+    const tools = toolNames[toolset] ?? [];
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Toolset "${toolset}" disabled. ${tools.length} tools hidden:\n${tools.map((t) => `  - ${t}`).join("\n")}\n\nUse enable_toolset("${toolset}") to re-enable them.`,
+            },
+        ],
+    };
+});
+// ─── Start server ────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("LaunchPath MCP Server running on stdio");
+}
+main().catch((err) => {
+    console.error("Failed to start LaunchPath MCP Server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/tools/agents.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Agent Management toolset (default) — create, create_from_prompt, update, delete
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LaunchPathClient } from "../client.js";
+export declare function registerAgentManagementTools(server: McpServer, client: LaunchPathClient): void;

package/build/tools/agents.js

@@ -0,0 +1,249 @@
+/**
+ * Agent Management toolset (default) — create, create_from_prompt, update, delete
+ */
+import { z } from "zod";
+import { formatError } from "../client.js";
+export function registerAgentManagementTools(server, client) {
+    // --- create_agent ---
+    server.registerTool("create_agent", {
+        title: "Create Agent",
+        description: "Create a new blank agent. Use this for manual configuration. For AI-generated agents, use create_agent_from_prompt instead.",
+        inputSchema: {
+            name: z.string().describe("Agent name"),
+            description: z
+                .string()
+                .optional()
+                .describe("Short description of what the agent does"),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ name, description }) => {
+        const res = await client.post("/api/agents/create-blank", {
+            name,
+            description,
+        });
+        if (res.error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: formatError(res.error, res.status) }],
+            };
+        }
+        const agentData = res.data;
+        let text = `Agent created successfully.\n\n${JSON.stringify(res.data, null, 2)}`;
+        text += `\n\n## Next Steps`;
+        text += `\n1. **Add knowledge** — use scrape_website to add website content, or add_faq for Q&A pairs`;
+        text += `\n2. **Add integrations** — use enable_toolset("composio") to browse and add tools like Google Calendar, Gmail, etc.`;
+        text += `\n3. **Configure** — use update_agent to set the system prompt, personality, and greeting`;
+        text += `\n4. **Deploy** — use deploy_channel to create a website widget or API endpoint`;
+        text += `\n5. **Test** — use chat_with_agent to verify it works correctly`;
+        if (agentData?.agentId) {
+            text += `\n\nDashboard: ${client.dashboardUrl}/dashboard/agents/${agentData.agentId}`;
+        }
+        return {
+            content: [{ type: "text", text }],
+        };
+    });
+    // --- create_agent_from_prompt ---
+    server.registerTool("create_agent_from_prompt", {
+        title: "Create Agent from Prompt",
+        description: "AI-generate an agent from a natural language description. Creates the agent with an optimized system prompt, personality, greeting, and suggested tools. Takes 10-30 seconds.",
+        inputSchema: {
+            prompt: z
+                .string()
+                .describe("Natural language description of the agent. Be specific about the business, role, and behavior. Example: 'A customer support bot for a dental practice that answers questions about services, pricing, and scheduling.'"),
+            name: z
+                .string()
+                .optional()
+                .describe("Override the AI-generated agent name"),
+            website_url: z
+                .string()
+                .optional()
+                .describe("URL to scrape for context. The AI will use this to understand the business."),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, name, website_url }) => {
+        const body = { prompt };
+        if (name)
+            body.name = name;
+        if (website_url)
+            body.websiteUrl = website_url;
+        const res = await client.consumeSSE("POST", "/api/agents/generate", body);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(res.error, res.status, "Agent generation may have timed out. Try a shorter prompt or retry."),
+                    },
+                ],
+            };
+        }
+        let text = `Agent generated successfully.\n\n${res.data?.text ?? ""}`;
+        text += `\n\n## Next Steps`;
+        text += `\n1. **Add knowledge** — use discover_pages to find pages on the business website, then scrape_website for each important page`;
+        text += `\n2. **Generate FAQs** — after scraping, use generate_faqs to auto-create Q&A pairs from the content`;
+        text += `\n3. **Add integrations** — if the agent needs tools (calendar booking, email, etc.), use enable_toolset("composio") to browse and add them`;
+        text += `\n4. **Deploy** — use deploy_channel(channel_type: "widget") to create a website chat widget`;
+        text += `\n5. **Test** — use chat_with_agent to send test messages and verify quality`;
+        return {
+            content: [{ type: "text", text }],
+        };
+    });
+    // --- update_agent ---
+    server.registerTool("update_agent", {
+        title: "Update Agent",
+        description: "Update any agent configuration field: name, system prompt, personality, model, greeting, tool guidelines, or status. Use get_agent first to see current values.",
+        inputSchema: {
+            agent_id: z.string().describe("The agent's UUID"),
+            name: z.string().optional().describe("New agent name"),
+            description: z.string().optional().describe("New description"),
+            system_prompt: z
+                .string()
+                .optional()
+                .describe("New system prompt — the core instructions for the agent"),
+            personality: z
+                .string()
+                .optional()
+                .describe("Personality traits (e.g., friendly, professional, concise)"),
+            model: z
+                .string()
+                .optional()
+                .describe('Model ID. Use slash-prefix for OpenRouter (e.g., "openai/gpt-4o-mini") or bare for Anthropic (e.g., "claude-sonnet-4-5-20250929")'),
+            greeting: z
+                .string()
+                .optional()
+                .describe("Initial greeting message shown to users"),
+            tool_guidelines: z
+                .string()
+                .optional()
+                .describe("Instructions for how the agent should use its tools"),
+            status: z
+                .enum(["active", "draft", "archived"])
+                .optional()
+                .describe("Agent status"),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ agent_id, name, description, system_prompt, personality, model, greeting, tool_guidelines, status, }) => {
+        const body = {};
+        if (name !== undefined)
+            body.name = name;
+        if (description !== undefined)
+            body.description = description;
+        if (system_prompt !== undefined)
+            body.system_prompt = system_prompt;
+        if (personality !== undefined)
+            body.personality = personality;
+        if (model !== undefined)
+            body.model = model;
+        if (greeting !== undefined)
+            body.greeting = greeting;
+        if (tool_guidelines !== undefined)
+            body.tool_guidelines = tool_guidelines;
+        if (status !== undefined)
+            body.status = status;
+        if (Object.keys(body).length === 0) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "No fields to update. Provide at least one field to change.",
+                    },
+                ],
+            };
+        }
+        const res = await client.patch(`/api/agents/${agent_id}`, body);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(res.error, res.status, "Use list_agents to verify the agent_id."),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Agent updated successfully.\n\n${JSON.stringify(res.data, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // --- clone_agent ---
+    server.registerTool("clone_agent", {
+        title: "Clone Agent",
+        description: "Create a full copy of an agent including its configuration, tools, knowledge base, and embeddings. The clone is independent — changes to one don't affect the other.",
+        inputSchema: {
+            agent_id: z.string().describe("The agent's UUID to clone"),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ agent_id }) => {
+        const res = await client.post(`/api/agents/${agent_id}/clone`);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(res.error, res.status, "Use list_agents to verify the agent_id."),
+                    },
+                ],
+            };
+        }
+        const cloneData = res.data;
+        let text = `Agent cloned successfully.\n\n${JSON.stringify(res.data, null, 2)}`;
+        if (cloneData?.id) {
+            text += `\n\nDashboard: ${client.dashboardUrl}/dashboard/agents/${cloneData.id}`;
+        }
+        return {
+            content: [{ type: "text", text }],
+        };
+    });
+    // --- delete_agent ---
+    server.registerTool("delete_agent", {
+        title: "Delete Agent",
+        description: "Permanently delete an agent and all associated data (knowledge base, tools, channels, conversations). This cannot be undone.",
+        inputSchema: {
+            agent_id: z.string().describe("The agent's UUID"),
+        },
+        annotations: {
+            destructiveHint: true,
+            idempotentHint: true,
+        },
+    }, async ({ agent_id }) => {
+        const res = await client.del(`/api/agents/${agent_id}`);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(res.error, res.status, "Use list_agents to verify the agent_id."),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                { type: "text", text: `Agent ${agent_id} deleted successfully.` },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=agents.js.map