# Peach - WhatsApp Business Messaging API

Peach AI MCP is an MCP to manage templates, chatbots and messaging using WhatsApp Business API. This is the complete and most comprehensive MCP for WhatsApp Business API.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add peachai/peach

# Browse available tools
npx -y @smithery/cli@latest tool list peachai/peach

# Get full schema for a tool
npx -y @smithery/cli@latest tool get peachai/peach peach_send_template_message

# Call a tool
npx -y @smithery/cli@latest tool call peachai/peach peach_send_template_message '{}'
```

## Direct MCP Connection

Endpoint: `https://peach--peachai.run.tools`

**Required config:**
- `X-Account-Api-Key` (header) — Alternatively, you can also use Authorization headers.

## Tools (26)

- `peach_send_template_message` — Send a WhatsApp template message to a contact via the Peach API
- `peach_launch_broadcast` — Create and launch a broadcast campaign to multiple contacts via the Peach API
- `peach_connect_to_ai_agent` — Send a template message to a contact and connect them to an AI agent for automated follow-up
- `peach_send_app_message` — Trigger a flow or app-initiated message to a contact via the Peach API
- `peach_get_event_status` — Get the status and details of a specific event by its ID
- `peach_list_template_messages` — List template messages sent via the Peach API with optional filters
- `peach_list_templates` — List all WhatsApp templates in the Peach account
- `peach_get_template` — Get a specific WhatsApp template by its ID or template name
- `peach_create_template` — Create a new WhatsApp template in the Peach account. Must include at least a body component in components_attributes.
- `peach_update_template` — Update an existing WhatsApp template's components or category
- `peach_archive_template` — Archive a WhatsApp template (must be approved, rejected, or draft status)
- `peach_pause_template` — Pause an approved WhatsApp template to temporarily stop it from being used
- `peach_submit_template` — Submit a WhatsApp template for review and approval by Meta
- `peach_create_contact` — Create or upsert a single contact in the Peach account
- `peach_create_contacts` — Create or upsert multiple contacts in bulk in the Peach account
- `peach_update_contact` — Update an existing contact identified by their phone number
- `peach_list_messages` — List messages in the Peach account with optional filters
- `peach_list_media` — List media files uploaded to the Peach account
- `peach_upload_media` — Upload a media file to Peach using base64-encoded file content
- `peach_delete_media` — Delete a media file from the Peach account by its ID
- `peach_list_ai_agents` — List all AI Agents (AiFlow) in the Peach account
- `peach_get_ai_agent` — Get details of a specific AI Agent by its ID, including its system instructions
- `peach_create_ai_agent` — Create a new AI Agent with system instructions
- `peach_update_ai_agent` — Update an existing AI Agent and/or its system instructions
- `peach_list_ai_agent_sessions` — List recent interaction sessions (StreamSessions) for a specific AI Agent
- `peach_get_ai_agent_transcript` — Get the detailed message transcript for a specific AI Agent session

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get peachai/peach <tool-name>
```