@launchpath-ai/mcp-server 1.0.0

package/build/tools/whatsapp.js

@@ -0,0 +1,399 @@
+/**
+ * WhatsApp toolset (on-demand) — templates, broadcasts, contacts, sequences,
+ * activation, enrollment
+ */
+import { z } from "zod";
+import { formatError } from "../client.js";
+export function registerWhatsAppTools(server, client) {
+    // --- list_wa_templates ---
+    server.registerTool("list_wa_templates", {
+        title: "List WhatsApp Templates",
+        description: "List WhatsApp message templates for a channel. Templates must be approved by Meta before sending.",
+        inputSchema: {
+            agent_id: z.string().describe("The agent's UUID"),
+            channel_id: z.string().describe("The WhatsApp channel's UUID"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ agent_id, channel_id }) => {
+        const res = await client.get(`/api/agents/${agent_id}/channels/${channel_id}/templates`);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: formatError(res.error, res.status) }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // --- create_wa_template ---
+    server.registerTool("create_wa_template", {
+        title: "Create WhatsApp Template",
+        description: "Create and submit a WhatsApp message template for Meta approval. Templates are required before sending broadcasts. Approval typically takes 1-24 hours.",
+        inputSchema: {
+            agent_id: z.string().describe("The agent's UUID"),
+            channel_id: z.string().describe("The WhatsApp channel's UUID"),
+            name: z
+                .string()
+                .describe("Template name (lowercase, underscores only, e.g., 'welcome_message')"),
+            category: z
+                .enum(["UTILITY", "MARKETING", "AUTHENTICATION"])
+                .describe("Template category for Meta review"),
+            language: z.string().describe("Language code (e.g., 'en_US', 'es')"),
+            body: z
+                .string()
+                .describe("Message body text. Use {{1}}, {{2}}, etc. for variables."),
+            header: z.string().optional().describe("Optional header text"),
+            footer: z.string().optional().describe("Optional footer text"),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ agent_id, channel_id, name, category, language, body, header, footer }) => {
+        const reqBody = { name, category, language, body };
+        if (header)
+            reqBody.header = header;
+        if (footer)
+            reqBody.footer = footer;
+        const res = await client.post(`/api/agents/${agent_id}/channels/${channel_id}/templates`, reqBody);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: formatError(res.error, res.status) }],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `WhatsApp template created and submitted for approval.\n\n${JSON.stringify(res.data, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // --- send_wa_broadcast ---
+    server.registerTool("send_wa_broadcast", {
+        title: "Send WhatsApp Broadcast",
+        description: "Send a template message to contacts via WhatsApp. This sends REAL messages to REAL people. The template must be approved by Meta first. Provide contact_ids for specific contacts, or audience_filter to target by tags/status.",
+        inputSchema: {
+            agent_id: z.string().describe("The agent's UUID"),
+            channel_id: z.string().describe("The WhatsApp channel's UUID"),
+            template_id: z.string().describe("The approved template's UUID"),
+            contact_ids: z
+                .array(z.string())
+                .optional()
+                .describe("Send to specific contacts by UUID"),
+            audience_filter: z
+                .object({
+                tags: z.array(z.string()).optional().describe("Filter contacts by tags"),
+                status: z.string().optional().describe("Filter contacts by status (e.g., 'active')"),
+            })
+                .optional()
+                .describe('Filter contacts by tags/status (e.g., { tags: ["vip"], status: "active" })'),
+            variable_mapping: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe('Map template vars to contact fields for personalization (e.g., { "1": "name", "2": "custom_fields.company" })'),
+            scheduled_for: z
+                .string()
+                .optional()
+                .describe("ISO datetime to schedule the send (e.g., '2026-04-01T10:00:00Z')"),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ agent_id, channel_id, template_id, contact_ids, audience_filter, variable_mapping, scheduled_for }) => {
+        const body = { template_id };
+        if (contact_ids)
+            body.contact_ids = contact_ids;
+        if (audience_filter)
+            body.audience_filter = audience_filter;
+        if (variable_mapping)
+            body.variable_mapping = variable_mapping;
+        if (scheduled_for)
+            body.scheduled_for = scheduled_for;
+        const res = await client.post(`/api/agents/${agent_id}/channels/${channel_id}/templates/${template_id}/bulk-send`, body);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(res.error, res.status, "Verify the template is approved (status: APPROVED) and contacts exist. Provide either contact_ids or audience_filter."),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Broadcast sent successfully.\n\n${JSON.stringify(res.data, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // --- list_wa_contacts ---
+    server.registerTool("list_wa_contacts", {
+        title: "List WhatsApp Contacts",
+        description: "List contacts for a campaign. Contacts are people you can send WhatsApp messages to.",
+        inputSchema: {
+            campaign_id: z.string().describe("The campaign's UUID"),
+            status: z.string().optional().describe("Filter by contact status"),
+            tag: z.string().optional().describe("Filter by tag"),
+            limit: z.number().optional().describe("Max contacts to return (default: 50)"),
+            offset: z.number().optional().describe("Number of contacts to skip for pagination"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ campaign_id, status, tag, limit, offset }) => {
+        const params = new URLSearchParams();
+        if (status)
+            params.set("status", status);
+        if (tag)
+            params.set("tag", tag);
+        params.set("limit", String(limit ?? 50));
+        if (offset)
+            params.set("offset", String(offset));
+        const qs = params.toString() ? `?${params.toString()}` : "";
+        const res = await client.get(`/api/campaigns/${campaign_id}/contacts${qs}`);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: formatError(res.error, res.status) }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // --- import_wa_contacts ---
+    server.registerTool("import_wa_contacts", {
+        title: "Import WhatsApp Contacts",
+        description: "Import contacts into a campaign. Each contact needs at minimum a phone number.",
+        inputSchema: {
+            campaign_id: z.string().describe("The campaign's UUID"),
+            contacts: z
+                .array(z.object({
+                phone: z.string().describe("Phone number with country code (e.g., '+1234567890')"),
+                name: z.string().optional().describe("Contact name"),
+                email: z.string().optional().describe("Contact email"),
+                tags: z.array(z.string()).optional().describe("Tags for segmentation"),
+            }))
+                .describe("Array of contacts to import"),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ campaign_id, contacts }) => {
+        const res = await client.post(`/api/campaigns/${campaign_id}/contacts/ingest`, { contacts });
+        if (res.error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: formatError(res.error, res.status) }],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Contacts imported successfully.\n\n${JSON.stringify(res.data, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // --- create_wa_sequence ---
+    server.registerTool("create_wa_sequence", {
+        title: "Create WhatsApp Sequence",
+        description: "Create a drip campaign sequence with timed sends. Steps execute in order with configurable delays. Sequences start as drafts — use activate_wa_sequence to start sending.",
+        inputSchema: {
+            campaign_id: z.string().describe("The campaign's UUID"),
+            name: z.string().describe("Sequence name"),
+            steps: z
+                .array(z.object({
+                template_id: z
+                    .string()
+                    .optional()
+                    .describe("Template UUID (required for template steps)"),
+                delay_hours: z
+                    .number()
+                    .describe("Hours to wait before sending this step (0 for immediate)"),
+                type: z
+                    .enum(["template", "text"])
+                    .optional()
+                    .describe('Step type: "template" (default) or "text" for free-text messages'),
+                text_content: z
+                    .string()
+                    .optional()
+                    .describe("Message text for text steps (max 4096 chars). Only works within 24h of last customer reply."),
+                variable_mapping: z
+                    .record(z.string(), z.string())
+                    .optional()
+                    .describe('Map template vars to contact fields (e.g., { "1": "name" })'),
+                stop_on_reply: z
+                    .boolean()
+                    .optional()
+                    .describe("Stop sequence if contact replies at this step"),
+            }))
+                .describe("Ordered array of sequence steps"),
+            auto_enroll_on_import: z
+                .boolean()
+                .optional()
+                .describe("Automatically enroll new contacts when they are imported via CSV or API"),
+            auto_enroll_on_tags: z
+                .array(z.string())
+                .optional()
+                .describe('Auto-enroll contacts when they receive any of these tags (e.g., ["lead", "interested"])'),
+            stop_on_reply: z
+                .boolean()
+                .optional()
+                .describe("Stop the sequence when a contact replies (default: true). Set to false to keep sending regardless of replies."),
+            stop_on_tags: z
+                .array(z.string())
+                .optional()
+                .describe('Safety net — automatically remove a contact from this sequence if they get any of these tags (e.g., ["unsubscribed", "purchased"])'),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ campaign_id, name, steps, auto_enroll_on_import, auto_enroll_on_tags, stop_on_reply, stop_on_tags }) => {
+        // Map snake_case fields to camelCase for the backend
+        const mappedSteps = steps.map((step) => {
+            const mapped = {
+                delayMinutes: step.delay_hours * 60,
+            };
+            if (step.template_id)
+                mapped.templateId = step.template_id;
+            if (step.type)
+                mapped.type = step.type;
+            if (step.text_content)
+                mapped.textContent = step.text_content;
+            if (step.variable_mapping)
+                mapped.variableMapping = step.variable_mapping;
+            if (step.stop_on_reply !== undefined)
+                mapped.stopOnReply = step.stop_on_reply;
+            return mapped;
+        });
+        const body = { name, steps: mappedSteps };
+        // Build auto_enroll object matching backend shape: { on_ingest?: boolean, on_tag?: string[] }
+        const autoEnroll = {};
+        if (auto_enroll_on_import !== undefined)
+            autoEnroll.on_ingest = auto_enroll_on_import;
+        if (auto_enroll_on_tags)
+            autoEnroll.on_tag = auto_enroll_on_tags;
+        if (Object.keys(autoEnroll).length > 0)
+            body.auto_enroll = autoEnroll;
+        if (stop_on_reply !== undefined)
+            body.stop_on_reply = stop_on_reply;
+        if (stop_on_tags)
+            body.stop_on_tags = stop_on_tags;
+        const res = await client.post(`/api/campaigns/${campaign_id}/sequences`, body);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: formatError(res.error, res.status) }],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Sequence created successfully. Use activate_wa_sequence to start it, then enroll_wa_contacts to add contacts.\n\n${JSON.stringify(res.data, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // --- activate_wa_sequence ---
+    server.registerTool("activate_wa_sequence", {
+        title: "Activate WhatsApp Sequence",
+        description: "Activate or pause a WhatsApp drip sequence. Sequences start as drafts — activate them to begin sending to enrolled contacts.",
+        inputSchema: {
+            campaign_id: z.string().describe("The campaign's UUID"),
+            sequence_id: z.string().describe("The sequence's UUID"),
+            status: z
+                .enum(["active", "paused"])
+                .describe('Set to "active" to start sending, or "paused" to stop'),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ campaign_id, sequence_id, status }) => {
+        const res = await client.patch(`/api/campaigns/${campaign_id}/sequences/${sequence_id}`, { status });
+        if (res.error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: formatError(res.error, res.status) }],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Sequence ${status === "active" ? "activated" : "paused"} successfully.\n\n${JSON.stringify(res.data, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // --- enroll_wa_contacts ---
+    server.registerTool("enroll_wa_contacts", {
+        title: "Enroll Contacts in Sequence",
+        description: "Enroll contacts into an active WhatsApp sequence. Provide contact_ids for specific contacts, or filter to enroll by tags/status. The sequence must be active.",
+        inputSchema: {
+            campaign_id: z.string().describe("The campaign's UUID"),
+            sequence_id: z.string().describe("The sequence's UUID"),
+            contact_ids: z
+                .array(z.string())
+                .optional()
+                .describe("Specific contact UUIDs to enroll (max 1000)"),
+            filter: z
+                .object({
+                tags: z.array(z.string()).optional().describe("Enroll contacts with these tags"),
+                status: z.string().optional().describe("Enroll contacts with this status"),
+            })
+                .optional()
+                .describe("Filter to select contacts for enrollment"),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ campaign_id, sequence_id, contact_ids, filter }) => {
+        const body = {};
+        if (contact_ids)
+            body.contactIds = contact_ids;
+        if (filter)
+            body.filter = filter;
+        const res = await client.post(`/api/campaigns/${campaign_id}/sequences/${sequence_id}/enroll`, body);
+        if (res.error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(res.error, res.status, "Make sure the sequence is active (use activate_wa_sequence first) and contacts exist."),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Contacts enrolled in sequence successfully.\n\n${JSON.stringify(res.data, null, 2)}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=whatsapp.js.map

package/build/tools/whatsapp.js.map

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

package/build/types.d.ts

@@ -0,0 +1,87 @@
+/** Shared types for LaunchPath MCP Server */
+export interface LaunchPathConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+export interface ApiResponse<T = unknown> {
+    data?: T;
+    error?: string;
+    status: number;
+}
+export interface Agent {
+    id: string;
+    name: string;
+    description: string | null;
+    status: "active" | "draft" | "archived";
+    model: string;
+    template_id: string | null;
+    knowledge_enabled: boolean;
+    created_at: string;
+    updated_at: string;
+    _counts?: {
+        tools: number;
+        knowledge_docs: number;
+        channels: number;
+    };
+}
+export interface AgentDetail extends Agent {
+    system_prompt: string | null;
+    personality: string | null;
+    greeting: string | null;
+    tool_guidelines: string | null;
+    user_id: string;
+}
+export interface KnowledgeDocument {
+    id: string;
+    agent_id: string;
+    title: string;
+    doc_type: string;
+    source_url: string | null;
+    status: string;
+    chunk_count: number;
+    created_at: string;
+}
+export interface Channel {
+    id: string;
+    agent_id: string;
+    channel_type: string;
+    name: string;
+    is_enabled: boolean;
+    allowed_origins: string[] | null;
+    rate_limit_rpm: number | null;
+    widget_config: Record<string, unknown> | null;
+    token: string | null;
+    created_at: string;
+}
+export interface Client {
+    id: string;
+    name: string;
+    email: string | null;
+    website: string | null;
+    logo_url: string | null;
+    created_at: string;
+}
+export interface Campaign {
+    id: string;
+    name: string;
+    agent_id: string;
+    client_id: string;
+    status: string;
+    channel_type: string | null;
+    created_at: string;
+}
+export interface Conversation {
+    id: string;
+    agent_id: string;
+    channel_id: string | null;
+    status: string;
+    message_count: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface ToolsetDefinition {
+    name: string;
+    description: string;
+    isDefault: boolean;
+    register: () => void;
+}

package/build/types.js

@@ -0,0 +1,3 @@
+/** Shared types for LaunchPath MCP Server */
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6CAA6C"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@launchpath-ai/mcp-server",
+  "version": "1.0.0",
+  "description": "LaunchPath MCP Server — manage AI agents, knowledge bases, deployments, clients, and campaigns from Claude Code",
+  "type": "module",
+  "bin": {
+    "launchpath-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai-agents",
+    "launchpath"
+  ],
+  "license": "MIT",
+  "files": [
+    "build",
+    "skills",
+    "plugin.json",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/launchpath/mcp-server"
+  },
+  "homepage": "https://launchpath.ai"
+}

package/plugin.json

@@ -0,0 +1,28 @@
+{
+  "name": "launchpath",
+  "version": "1.0.0",
+  "title": "LaunchPath — AI Agent Deployment",
+  "description": "Create, train, deploy, and manage AI agents for businesses — entirely from Claude Code. Build an AI agency from your terminal.",
+  "author": "LaunchPath",
+  "homepage": "https://launchpath.ai",
+  "repository": "https://github.com/launchpath/claude-plugin",
+  "mcpServers": {
+    "launchpath": {
+      "command": "npx",
+      "args": ["@launchpath/mcp-server"],
+      "env": {
+        "LAUNCHPATH_API_KEY": {
+          "description": "Your LaunchPath API key. Get it from Settings → API Keys in the LaunchPath dashboard.",
+          "required": true
+        }
+      }
+    }
+  },
+  "skills": [
+    "skills/deploy-agent",
+    "skills/setup-client",
+    "skills/agent-report",
+    "skills/launchpath-guide",
+    "skills/whatsapp-campaign"
+  ]
+}

package/skills/agent-report/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: agent-report
+description: Pull a summary of all your LaunchPath agents — status, conversations, deployments, and what needs attention.
+allowed-tools: mcp__launchpath__*
+context: fork
+---
+
+You are generating a report on the user's LaunchPath agents. Follow this workflow:
+
+## Step 1: Gather data
+
+1. Call `list_agents` to get all agents
+2. Call `enable_toolset("analytics")` to load analytics tools
+3. For each agent, call `list_channels` to see deployment status
+4. For agents that are deployed, call `list_conversations` to see recent activity
+
+## Step 2: Build the report
+
+Present a structured report with these sections:
+
+### Overview
+- Total agents (active vs draft vs archived)
+- Total deployed channels
+- Total conversations in the last 7 days
+
+### Agent Status Table
+For each agent, show:
+| Agent | Status | Channels | Knowledge Docs | Recent Conversations |
+
+### Needs Attention
+Flag any issues:
+- Agents that are **draft with no recent edits** (may be abandoned)
+- Agents that are **deployed but have zero conversations** (may need promotion)
+- Agents with **no knowledge base** (will give poor responses)
+- Agents with **high human takeover rates** (may need prompt improvements)
+
+### Recommendations
+Suggest concrete next steps:
+- Which agents to activate or archive
+- Which agents need more knowledge
+- Which agents should be tested
+- Growth opportunities (new channels, new clients)
+
+Keep the report concise and actionable. Use tables and bullet points, not paragraphs.