@peachai/mcp 0.1.0 → 0.1.2

package/.mcpregistry_github_token

@@ -0,0 +1 @@
+ghu_PQNCitmxq0E8YfTwFBcZf6l9hY3LXk2DOQO8

package/.mcpregistry_registry_token

@@ -0,0 +1 @@
+{"token":"eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJtY3AtcmVnaXN0cnkiLCJleHAiOjE3NzIyOTU5NTQsIm5iZiI6MTc3MjI5NTY1NCwiaWF0IjoxNzcyMjk1NjU0LCJhdXRoX21ldGhvZCI6ImdpdGh1Yi1hdCIsImF1dGhfbWV0aG9kX3N1YiI6InNoaG4xMjMiLCJwZXJtaXNzaW9ucyI6W3siYWN0aW9uIjoicHVibGlzaCIsInJlc291cmNlIjoiaW8uZ2l0aHViLnNoaG4xMjMvKiJ9LHsiYWN0aW9uIjoicHVibGlzaCIsInJlc291cmNlIjoiaW8uZ2l0aHViLnRyeXBlYWNoLWlvLyoifV19.e7iyCgI9PVtG0NiKp9K2T8U9yGpKI0nMv0eELfMI4FOo1qFvUWrP25bilBKWmm1EJD8OE6So5CnWKhUIOHToBA","expires_at":1772295954}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CStack Technologies Private Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,132 @@
+# @peachai/mcp
+
+MCP (Model Context Protocol) server for the [Peach](https://trypeach.ai) WhatsApp messaging platform. Lets AI assistants like Claude send messages, manage templates, contacts, and media directly through your Peach account.
+
+## Requirements
+
+- Node.js 18 or higher
+- A Peach account with an API key
+
+## Getting your API key
+
+Log in to [app.trypeach.ai](https://app.trypeach.ai), go to **Settings → API**, and copy your API key.
+
+## Setup
+
+### Claude Desktop
+
+Add the following to your `claude_desktop_config.json`:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "peach": {
+      "command": "npx",
+      "args": ["-y", "@peachai/mcp"],
+      "env": {
+        "PEACH_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You should see the Peach tools available in your conversation.
+
+### Cursor
+
+Go to **Settings → MCP** and add:
+
+```json
+{
+  "peach": {
+    "command": "npx",
+    "args": ["-y", "@peachai/mcp"],
+    "env": {
+      "PEACH_API_KEY": "your-api-key"
+    }
+  }
+}
+```
+
+### Claude Code
+
+Run this command to add Peach AI to your Claude Code setup:
+
+```bash
+claude mcp add --scope user --env PEACH_API_KEY=your-api-key peach -- npx -y @peachai/mcp
+```
+
+Or add it manually to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "peach": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@peachai/mcp"],
+      "env": {
+        "PEACH_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Available tools
+
+### Messaging
+| Tool | Description |
+|------|-------------|
+| `peach_send_template_message` | Send a WhatsApp template message to a contact |
+| `peach_send_app_message` | Trigger a flow or app-initiated message |
+| `peach_connect_to_ai_agent` | Send a template and connect the contact to an AI agent |
+| `peach_get_event_status` | Check the status of a sent event |
+| `peach_list_template_messages` | List sent template messages with filters |
+
+### Broadcasts
+| Tool | Description |
+|------|-------------|
+| `peach_launch_broadcast` | Create and launch a broadcast campaign |
+
+### Templates
+| Tool | Description |
+|------|-------------|
+| `peach_list_templates` | List all WhatsApp templates |
+| `peach_get_template` | Get a specific template by ID or name |
+| `peach_create_template` | Create a new WhatsApp template |
+| `peach_update_template` | Update an existing template |
+| `peach_submit_template` | Submit a template for Meta review |
+| `peach_pause_template` | Pause an approved template |
+| `peach_archive_template` | Archive a template |
+
+### Contacts
+| Tool | Description |
+|------|-------------|
+| `peach_create_contact` | Create or upsert a single contact |
+| `peach_create_contacts` | Bulk create or upsert contacts |
+| `peach_update_contact` | Update a contact by phone number |
+
+### Media
+| Tool | Description |
+|------|-------------|
+| `peach_list_media` | List uploaded media files |
+| `peach_upload_media` | Upload a media file (base64) |
+| `peach_delete_media` | Delete a media file |
+
+### Messages
+| Tool | Description |
+|------|-------------|
+| `peach_list_messages` | List messages with optional filters |
+
+## Example prompts
+
+- *"Send the order_confirmation template to +14155552671 with order ID 12345"*
+- *"Create a new MARKETING template called summer_sale with a body saying 'Get 20% off this weekend!'"*
+- *"List all my approved WhatsApp templates"*
+- *"Update the contact +14155552671's name to John Smith"*
+- *"Launch a broadcast using template promo_v2 to audience list abc123"*

package/dist/index.js

@@ -8,7 +8,7 @@ import { registerMessageTools } from "./tools/messages.js";
 import { registerMediaTools } from "./tools/media.js";
 const server = new McpServer({
     name: "peach",
-    version: "0.1.0",
+    version: "0.1.1",
 });
 registerEventTools(server);
 registerTemplateTools(server);

package/package.json

@@ -1,7 +1,24 @@
 {
   "name": "@peachai/mcp",
-  "version": "0.1.0",
-  "description": "MCP server for the Peach WhatsApp messaging platform",
+  "version": "0.1.2",
+  "description": "MCP server for the Peach AI WhatsApp Business Messaging Platform",
+  "author": "Peach AI <hello@trypeach.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/trypeach-ai/mcp.git"
+  },
+  "mcpName": "io.github.trypeach-io/mcp",
+  "homepage": "https://github.com/trypeach-ai/mcp#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "whatsapp",
+    "peach",
+    "peach-ai",
+    "messaging",
+    "claude"
+  ],
   "type": "module",
   "bin": {
     "peach-mcp": "dist/index.js"
@@ -22,4 +39,4 @@
     "tsx": "^4.19.0",
     "typescript": "^5.6.0"
   }
-}
+}

package/server.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.trypeach-io/mcp",
+  "description": "Send and manage WhatsApp messages, contacts, templates, and events via Peach AI.",
+  "repository": {
+    "url": "https://github.com/trypeach-io/mcp",
+    "source": "github"
+  },
+  "version": "0.1.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@peachai/mcp",
+      "version": "0.1.1",
+      "transport": {
+        "type": "streamable-http",
+        "url": "https://app.trypeach.ai/api/mcp",
+        "headers": [
+          { "name": "Authorization", "value": "{token}" }
+        ]
+      }
+    }
+  ]
+}
+

package/src/client.ts

@@ -0,0 +1,60 @@
+const BASE_URL = "https://app.trypeach.io";
+
+function getApiKey(): string {
+  const key = process.env.PEACH_API_KEY;
+  if (!key) {
+    throw new Error("PEACH_API_KEY environment variable is not set");
+  }
+  return key;
+}
+
+async function request<T>(
+  method: string,
+  path: string,
+  body?: unknown
+): Promise<T> {
+  const url = `${BASE_URL}${path}`;
+  const headers: Record<string, string> = {
+    Authorization: getApiKey(),
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  };
+
+  const response = await fetch(url, {
+    method,
+    headers,
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  });
+
+  if (!response.ok) {
+    let errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+    try {
+      const errorBody = await response.json();
+      errorMessage = JSON.stringify(errorBody);
+    } catch {
+      // ignore parse error, use status message
+    }
+    throw new Error(errorMessage);
+  }
+
+  if (response.status === 204) {
+    return undefined as T;
+  }
+
+  return response.json() as Promise<T>;
+}
+
+export const client = {
+  get<T>(path: string): Promise<T> {
+    return request<T>("GET", path);
+  },
+  post<T>(path: string, body: unknown): Promise<T> {
+    return request<T>("POST", path, body);
+  },
+  patch<T>(path: string, body: unknown): Promise<T> {
+    return request<T>("PATCH", path, body);
+  },
+  delete<T>(path: string): Promise<T> {
+    return request<T>("DELETE", path);
+  },
+};

package/src/index.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerEventTools } from "./tools/events.js";
+import { registerTemplateTools } from "./tools/templates.js";
+import { registerContactTools } from "./tools/contacts.js";
+import { registerMessageTools } from "./tools/messages.js";
+import { registerMediaTools } from "./tools/media.js";
+
+const server = new McpServer({
+  name: "peach",
+  version: "0.1.1",
+});
+
+registerEventTools(server);
+registerTemplateTools(server);
+registerContactTools(server);
+registerMessageTools(server);
+registerMediaTools(server);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools/contacts.ts

@@ -0,0 +1,59 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { client } from "../client.js";
+
+const ContactFields = {
+  phone_number: z.string().describe("Phone number in E.164 format (e.g. +14155552671)"),
+  name: z.string().optional().describe("Contact's full name"),
+  email: z.string().email().optional().describe("Contact's email address"),
+  timezone: z.string().optional().describe("Contact's timezone (e.g. America/New_York)"),
+  metadata: z.record(z.unknown()).optional().describe("Custom metadata key-value pairs (merged with existing)"),
+};
+
+export function registerContactTools(server: McpServer): void {
+  server.tool(
+    "peach_create_contact",
+    "Create or upsert a single contact in the Peach account",
+    ContactFields,
+    async (params) => {
+      const result = await client.post("/api/v1/contacts", params);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_create_contacts",
+    "Create or upsert multiple contacts in bulk in the Peach account",
+    {
+      contacts: z.array(z.object(ContactFields)).describe("Array of contacts to create or upsert"),
+    },
+    async ({ contacts }) => {
+      const result = await client.post("/api/v1/contacts", contacts);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_update_contact",
+    "Update an existing contact identified by their phone number",
+    {
+      phone_number: z.string().describe("Phone number of the contact to update in E.164 format (e.g. +14155552671)"),
+      name: z.string().optional().describe("Updated full name"),
+      email: z.string().email().optional().describe("Updated email address"),
+      age: z.number().int().optional().describe("Updated age"),
+      gender: z.string().optional().describe("Updated gender"),
+      language: z.string().optional().describe("Updated language code (e.g. en)"),
+      nickname: z.string().optional().describe("Updated nickname"),
+      opted_out: z.boolean().optional().describe("Whether the contact has opted out of messaging"),
+      timezone: z.string().optional().describe("Updated timezone (e.g. America/New_York)"),
+      metadata: z.record(z.unknown()).optional().describe("Custom metadata to deep-merge with existing"),
+    },
+    async ({ phone_number, ...updates }) => {
+      const result = await client.patch(
+        `/api/v1/contacts/${encodeURIComponent(phone_number)}`,
+        updates
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}

package/src/tools/events.ts

@@ -0,0 +1,142 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { client } from "../client.js";
+
+const ContactSchema = z.object({
+  phone_number: z.string().describe("Phone number in E.164 format (e.g. +14155552671)"),
+  name: z.string().optional().describe("Contact's full name"),
+  email: z.string().email().optional().describe("Contact's email address"),
+  metadata: z.record(z.unknown()).optional().describe("Custom metadata key-value pairs"),
+});
+
+export function registerEventTools(server: McpServer): void {
+  server.tool(
+    "peach_send_template_message",
+    "Send a WhatsApp template message to a contact via the Peach API",
+    {
+      contact: ContactSchema.describe("The recipient contact. phone_number is required."),
+      template_message: z.object({
+        whats_app_template_id: z.string().describe("ID of the WhatsApp template to use"),
+        liquid_values: z.record(z.unknown()).optional().describe("Variable values for template placeholders"),
+        business_phone_number: z.string().optional().describe("WA ID of the sending phone number to use"),
+      }).describe("Template message parameters"),
+    },
+    async ({ contact, template_message }) => {
+      const result = await client.post("/api/v1/events?sync=true", {
+        event_type: "send_template_message",
+        contact,
+        template_message,
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_launch_broadcast",
+    "Create and launch a broadcast campaign to multiple contacts via the Peach API",
+    {
+      broadcast: z.object({
+        whats_app_template_id: z.string().describe("ID of the WhatsApp template to use"),
+        name: z.string().describe("Name of the broadcast campaign"),
+        contacts: z.array(z.object({
+          phone_number: z.string().describe("Phone number in E.164 format"),
+          name: z.string().optional().describe("Contact name"),
+          liquid_values: z.record(z.unknown()).optional().describe("Per-contact template variable values"),
+        })).optional().describe("Explicit list of contacts to send to"),
+        audience_id: z.string().optional().describe("ID of an existing audience/list to send to"),
+        phone_number: z.string().optional().describe("WA ID of the sending phone number to use"),
+        delivery_mode: z.enum(["instant", "smart"]).optional().describe("Delivery mode: instant (asap) or smart (gradual)"),
+        scheduled_launch_time: z.string().optional().describe("ISO 8601 datetime to schedule the send (e.g. 2024-01-15T10:00:00Z)"),
+        liquid_values: z.record(z.unknown()).optional().describe("Global template variable values for all contacts"),
+      }).describe("Broadcast parameters"),
+    },
+    async ({ broadcast }) => {
+      const result = await client.post("/api/v1/events?sync=true", {
+        event_type: "send_broadcast",
+        broadcast,
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_connect_to_ai_agent",
+    "Send a template message to a contact and connect them to an AI agent for automated follow-up",
+    {
+      contact: ContactSchema.describe("The recipient contact. phone_number is required."),
+      template_message: z.object({
+        whats_app_template_id: z.string().describe("ID of the WhatsApp template to send"),
+        liquid_values: z.record(z.unknown()).optional().describe("Variable values for template placeholders"),
+        business_phone_number: z.string().optional().describe("WA ID of the sending phone number to use"),
+      }).describe("Template message parameters"),
+      ai_agent: z.object({
+        id: z.string().describe("ID of the AI agent to connect the contact to"),
+      }).optional().describe("AI agent to connect the contact to after the template message"),
+    },
+    async ({ contact, template_message, ai_agent }) => {
+      const result = await client.post("/api/v1/events?sync=true", {
+        event_type: "connect_to_ai_agent",
+        contact,
+        template_message,
+        ai_agent,
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_send_app_message",
+    "Trigger a flow or app-initiated message to a contact via the Peach API",
+    {
+      contact: ContactSchema.describe("The recipient contact. phone_number is required."),
+      flow: z.object({
+        id: z.string().describe("ID of the flow to execute"),
+        liquid_values: z.record(z.unknown()).optional().describe("Variable values for the flow"),
+        whats_app_template_id: z.string().optional().describe("Fallback template ID if the reply window is closed"),
+      }).describe("Flow parameters"),
+    },
+    async ({ contact, flow }) => {
+      const result = await client.post("/api/v1/events?sync=true", {
+        event_type: "send_app_message",
+        contact,
+        flow,
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_get_event_status",
+    "Get the status and details of a specific event by its ID",
+    {
+      event_id: z.string().describe("The ID of the event to retrieve"),
+    },
+    async ({ event_id }) => {
+      const result = await client.get(`/api/v1/events/${event_id}`);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_list_template_messages",
+    "List template messages sent via the Peach API with optional filters",
+    {
+      page: z.number().int().positive().optional().describe("Page number for pagination"),
+      per_page: z.number().int().positive().optional().describe("Number of results per page"),
+      status: z.string().optional().describe("Filter by message status (e.g. delivered, read, failed)"),
+      phone_number: z.string().optional().describe("Filter by recipient phone number in E.164 format"),
+      template_name: z.string().optional().describe("Filter by template name"),
+      from: z.string().optional().describe("ISO 8601 start datetime for filtering (e.g. 2024-01-01T00:00:00Z)"),
+      to: z.string().optional().describe("ISO 8601 end datetime for filtering (e.g. 2024-01-31T23:59:59Z)"),
+    },
+    async (params) => {
+      const query = new URLSearchParams();
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) query.set(key, String(value));
+      }
+      const qs = query.toString();
+      const result = await client.get(`/api/v1/template_messages${qs ? `?${qs}` : ""}`);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}

package/src/tools/media.ts

@@ -0,0 +1,55 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { client } from "../client.js";
+
+export function registerMediaTools(server: McpServer): void {
+  server.tool(
+    "peach_list_media",
+    "List media files uploaded to the Peach account",
+    {
+      page: z.number().int().positive().optional().describe("Page number for pagination"),
+    },
+    async (params) => {
+      const query = new URLSearchParams();
+      if (params.page !== undefined) query.set("page", String(params.page));
+      const qs = query.toString();
+      const result = await client.get(`/api/v1/medias${qs ? `?${qs}` : ""}`);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_upload_media",
+    "Upload a media file to Peach using base64-encoded file content",
+    {
+      data: z.string().describe("Base64-encoded file content"),
+      filename: z.string().describe("Filename including extension (e.g. photo.jpg)"),
+      content_type: z.string().optional().describe("MIME type of the file (e.g. image/jpeg, video/mp4)"),
+    },
+    async ({ data, filename, content_type }) => {
+      const result = await client.post("/api/v1/medias", {
+        media: { data, filename, content_type },
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_delete_media",
+    "Delete a media file from the Peach account by its ID",
+    {
+      media_id: z.string().describe("The ID of the media file to delete"),
+    },
+    async ({ media_id }) => {
+      const result = await client.delete(`/api/v1/medias/${media_id}`);
+      return {
+        content: [
+          {
+            type: "text",
+            text: result !== undefined ? JSON.stringify(result, null, 2) : "Media deleted successfully",
+          },
+        ],
+      };
+    }
+  );
+}

package/src/tools/messages.ts

@@ -0,0 +1,41 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { client } from "../client.js";
+
+export function registerMessageTools(server: McpServer): void {
+  server.tool(
+    "peach_list_messages",
+    "List messages in the Peach account with optional filters",
+    {
+      page: z.number().int().positive().optional().describe("Page number for pagination"),
+      per_page: z.number().int().positive().optional().describe("Number of results per page"),
+      phone_number: z
+        .string()
+        .optional()
+        .describe("Filter by contact phone number in E.164 format"),
+      direction: z
+        .enum(["inbound", "outbound"])
+        .optional()
+        .describe("Filter by message direction"),
+      from: z
+        .string()
+        .optional()
+        .describe("ISO 8601 start datetime for filtering (e.g. 2024-01-01T00:00:00Z)"),
+      to: z
+        .string()
+        .optional()
+        .describe("ISO 8601 end datetime for filtering (e.g. 2024-01-31T23:59:59Z)"),
+    },
+    async (params) => {
+      const query = new URLSearchParams();
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+          query.set(key, String(value));
+        }
+      }
+      const qs = query.toString();
+      const result = await client.get(`/api/v1/messages${qs ? `?${qs}` : ""}`);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}

package/src/tools/templates.ts

@@ -0,0 +1,130 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { client } from "../client.js";
+
+const ComponentAttributeSchema = z.object({
+  component_type: z.enum(["header", "body", "footer", "buttons"]).describe("Component type"),
+  sub_type: z.string().optional().describe("Button sub-type (e.g. quick_reply, url, phone_number)"),
+  data_type: z.string().optional().describe("Data type for the component (e.g. text, image, video, document)"),
+  name: z.string().optional().describe("Button label or component name"),
+  value: z.string().optional().describe("Text content or button value/URL"),
+  index: z.number().int().optional().describe("Position index of the component"),
+  id: z.number().int().optional().describe("Component ID (required when updating existing components)"),
+  _destroy: z.boolean().optional().describe("Set to true to remove this component during update"),
+});
+
+export function registerTemplateTools(server: McpServer): void {
+  server.tool(
+    "peach_list_templates",
+    "List all WhatsApp templates in the Peach account",
+    {
+      page: z.number().int().positive().optional().describe("Page number for pagination"),
+    },
+    async (params) => {
+      const query = new URLSearchParams();
+      if (params.page !== undefined) query.set("page", String(params.page));
+      const qs = query.toString();
+      const result = await client.get(`/api/v1/whats_app_templates${qs ? `?${qs}` : ""}`);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_get_template",
+    "Get a specific WhatsApp template by its ID or template name",
+    {
+      id: z.string().describe("The template ID or template_name"),
+    },
+    async ({ id }) => {
+      const result = await client.get(`/api/v1/whats_app_templates/${id}`);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_create_template",
+    "Create a new WhatsApp template in the Peach account. Must include at least a body component in components_attributes.",
+    {
+      template_name: z.string().describe("Unique name for the template (lowercase, underscores only, e.g. order_confirmation)"),
+      language: z.string().describe("Language code for the template (e.g. en, en_US)"),
+      category: z.enum(["MARKETING", "UTILITY", "AUTHENTICATION"]).describe("Template category as required by WhatsApp"),
+      components_attributes: z.array(ComponentAttributeSchema).describe(
+        "Template components. Must include a body component. Each component has component_type, value, and optional sub_type/data_type/name/index."
+      ),
+      purpose: z.string().optional().describe("Purpose of the template (e.g. general)"),
+      whats_app_business_account_id: z.string().optional().describe("External ID of the WhatsApp Business Account to use (defaults to the account's only WABA if there is one)"),
+      folder: z.string().optional().describe("Folder to organise the template into"),
+    },
+    async ({ template_name, language, category, components_attributes, purpose, whats_app_business_account_id, folder }) => {
+      const result = await client.post("/api/v1/whats_app_templates", {
+        whats_app_template: {
+          template_name,
+          language,
+          category,
+          components_attributes,
+          purpose,
+          whats_app_business_account_id,
+          folder,
+        },
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_update_template",
+    "Update an existing WhatsApp template's components or category",
+    {
+      id: z.string().describe("The template ID or template_name"),
+      components_attributes: z.array(ComponentAttributeSchema).optional().describe(
+        "Updated components. Include id on existing components to update them; set _destroy: true to remove one."
+      ),
+      category: z.enum(["MARKETING", "UTILITY", "AUTHENTICATION"]).optional().describe("Updated template category"),
+    },
+    async ({ id, components_attributes, category }) => {
+      const result = await client.patch(`/api/v1/whats_app_templates/${id}`, {
+        whats_app_template: {
+          components_attributes,
+          category,
+        },
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_archive_template",
+    "Archive a WhatsApp template (must be approved, rejected, or draft status)",
+    {
+      id: z.string().describe("The template ID or template_name"),
+    },
+    async ({ id }) => {
+      const result = await client.patch(`/api/v1/whats_app_templates/${id}/archive`, {});
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_pause_template",
+    "Pause an approved WhatsApp template to temporarily stop it from being used",
+    {
+      id: z.string().describe("The template ID or template_name"),
+    },
+    async ({ id }) => {
+      const result = await client.patch(`/api/v1/whats_app_templates/${id}/pause`, {});
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+
+  server.tool(
+    "peach_submit_template",
+    "Submit a WhatsApp template for review and approval by Meta",
+    {
+      id: z.string().describe("The template ID or template_name"),
+    },
+    async ({ id }) => {
+      const result = await client.patch(`/api/v1/whats_app_templates/${id}/submit`, {});
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+  );
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}