Trypeach Io

io.github.trypeach-ioPublished by GitHub account trypeach-iov0.1.3Updated Oct 24, 2026

Send and manage WhatsApp messages, contacts, templates, and events via Peach AI.

Overview

AI-generated overview

Connects an assistant to the Peach WhatsApp platform to send template messages, run broadcasts, and manage templates, contacts, and media.

What you can do
  • Send WhatsApp template messages, app-initiated or flow messages, and connect contacts to an AI agent; check event status and list sent template messages
  • Create, launch and track broadcast campaigns
  • List, get, create, update, submit for Meta review, pause and archive WhatsApp templates
  • Create, bulk upsert and update contacts by phone number
  • List, upload (base64) and delete media files, and list messages with filters
When to use it
Useful when you run WhatsApp outreach through Peach and want an assistant to draft and send template messages, launch broadcasts, or keep templates and contacts up to date from a chat instead of the Peach dashboard.
Requirements
A Peach account with an API key from the Peach app settings. Either the hosted endpoint with an Authorization header, or the local npm package run with npx, which needs Node.js 18 or higher and the PEACH_API_KEY environment variable. Desktop client only.
Before you install
The API key grants access to your Peach account; keep it out of shared configs. Tools send real WhatsApp messages, launch broadcasts to audiences, submit templates to Meta, and create, update or delete contacts and media, so actions are hard to undo and can reach real recipients.

Installation

In SourceWeft

  1. Open Trypeach Io in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@peachai/mcp

MCP (Model Context Protocol) server for the Peach 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, go to Settings → API, and copy your API key.

Setup

Hosted Server setup

Recommended Peach offers hosted MCP server. We recommend using this.

json
{  "mcpServers": {    "peach": {      "url": "https://app.trypeach.ai/api/mcp",      "headers": {        "Authorization": "<YOUR PEACH API KEY>"      }    }  }}

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"      }    }  }}

Antigravity

Go to Antigravity settings -> Customizations. Click Open MCP Config and add the following:

json
{  "mcpServers": {    "peach": {      "serverUrl": "https://app.trypeach.ai/api/mcp",       "headers": {        "Authorization": "<YOUR PEACH API KEY>"      }    }  }}

Available tools

Messaging

ToolDescription
peach_send_template_messageSend a WhatsApp template message to a contact
peach_send_app_messageTrigger a flow or app-initiated message
peach_connect_to_ai_agentSend a template and connect the contact to an AI agent
peach_get_event_statusCheck the status of a sent event
peach_list_template_messagesList sent template messages with filters

Broadcasts

ToolDescription
peach_launch_broadcastCreate and launch a broadcast campaign

Templates

ToolDescription
peach_list_templatesList all WhatsApp templates
peach_get_templateGet a specific template by ID or name
peach_create_templateCreate a new WhatsApp template
peach_update_templateUpdate an existing template
peach_submit_templateSubmit a template for Meta review
peach_pause_templatePause an approved template
peach_archive_templateArchive a template

Contacts

ToolDescription
peach_create_contactCreate or upsert a single contact
peach_create_contactsBulk create or upsert contacts
peach_update_contactUpdate a contact by phone number

Media

ToolDescription
peach_list_mediaList uploaded media files
peach_upload_mediaUpload a media file (base64)
peach_delete_mediaDelete a media file

Messages

ToolDescription
peach_list_messagesList 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"

Source: README.md at commit b33120b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts