electrical_services

WhatsApp MCP Server — Hosted Api Connectors Integration

MCP Server language Hosted language Public

Send WhatsApp messages, templates, interactive menus, and media — automate business messaging at scale.

@aerostack verified

• v0.1.0 • MIT • Updated Jun 28, 2026

add_circleAdd to Workspace

robot_2

Use with AI AssistantsMCP

Connect Claude, Cursor, or any MCP-compatible client — then call tools directly

① Add This MCP Server

Paste into your AI client config — then all its tools are available instantly.

.claude/mcp.json

{
  "mcpServers": {
    "whatsapp": {
      "url": "https://mcp.aerostack.dev/s/aerostack/mcp-whatsapp",
      "headers": {
        "Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
      }
    }
  }
}

Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.

② Call a Tool

Ask your AI assistant to call a specific tool, or send raw JSON-RPC:

+19 more

Natural Language Prompt

“Use the _ping tool to verify whatsapp credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”

Using a Workspace?

Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.

add_circleAdd to Workspace

description Overview

mcp-whatsapp — WhatsApp Business MCP Server

Send messages, manage templates, and handle media across WhatsApp Business from your AI agents.

WhatsApp Business reaches over 2 billion users and is the dominant messaging channel for customer communication in many markets. This MCP server covers the full Meta Cloud API v20.0 — session messages (text, image, video, document, audio, location, reactions), interactive messages (buttons, lists, CTA URLs), template management, media upload, and account management — letting your AI agents run real customer conversations at scale.

Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-whatsapp

What You Can Do

Send rich session messages (text, images, documents, interactive buttons and lists) to customers within the 24-hour conversation window
Use pre-approved templates to re-engage customers outside the window — order updates, appointment reminders, payment confirmations
Manage your template library: list, create, submit for Meta review, and delete templates
Upload media once to get a reusable media_id for efficient re-sending without re-uploading

Available Tools

Tool	Description
`get_business_profile`	Get business name, description, address, email, website, category, and profile picture
`update_business_profile`	Update any profile field: description, address, email, websites, vertical
`get_phone_number_info`	Get display number, verified name, quality rating, platform type, and throughput level
`get_account_info`	Get WABA name, currency, timezone, and template namespace
`send_text`	Send a text message, with optional URL preview
`send_image`	Send an image by URL or media_id, with optional caption
`send_document`	Send a document or file by URL or media_id, with optional caption and filename
`send_video`	Send a video by URL or media_id, with optional caption
`send_audio`	Send an audio message or voice note by URL or media_id
`send_location`	Send a location pin with latitude, longitude, optional name and address
`send_reaction`	React to a received message with an emoji
`send_buttons`	Send a message with 1–3 quick-reply buttons
`send_list`	Send a message with a scrollable list of options in sections (max 10 rows)
`send_cta_url`	Send a message with a URL call-to-action button
`list_templates`	List all templates with optional status filter (APPROVED, PENDING, REJECTED, PAUSED)
`get_template`	Get full template details including components and rejection reason
`send_template`	Send an approved template with variable values and optional media header
`create_template`	Submit a new template for Meta review
`delete_template`	Delete a template by name
`mark_as_read`	Mark a received message as read (shows blue double-tick to sender)
`delete_message`	Delete a sent message from the recipient's view
`upload_media`	Upload media from a public URL to WhatsApp servers, returns reusable media_id
`get_media_url`	Get the download URL for media received via webhook
`delete_media`	Delete uploaded media from WhatsApp servers

Configuration

Variable	Required	Description	How to Get
`WHATSAPP_ACCESS_TOKEN`	Yes	Bearer token for Meta Cloud API	developers.facebook.com → Your App → WhatsApp → Getting Started → copy Temporary access token (for testing) or generate a permanent System User token via Meta Business Manager → System Users
`WHATSAPP_PHONE_NUMBER_ID`	Yes	Numeric ID of the sending phone number	Same Getting Started page → copy Phone number ID (NOT the phone number itself)
`WHATSAPP_BUSINESS_ACCOUNT_ID`	For template tools	WABA ID — required for template management and account info	Same page → copy WhatsApp Business Account ID

Quick Start

Add to Aerostack Workspace

Go to aerostack.dev → Your Project → MCPs
Search for "WhatsApp" and click Add to Workspace
Add your secrets under Project → Secrets

Once added, every AI agent in your workspace can call WhatsApp tools automatically — no per-user setup needed.

Example Prompts

"Send a WhatsApp message to 15551234567 saying their order has shipped and will arrive by Thursday"
"List all APPROVED WhatsApp templates and show me their variable placeholders"
"Send the order_confirmation template to 447911123456 with order number ORD-8821 and total $49.99"

Direct API Call

curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-whatsapp \
  -H 'Content-Type: application/json' \
  -H 'X-Mcp-Secret-WHATSAPP-ACCESS-TOKEN: your-access-token' \
  -H 'X-Mcp-Secret-WHATSAPP-PHONE-NUMBER-ID: your-phone-number-id' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send_text","arguments":{"to":"15551234567","text":"Hello from Aerostack!"}}}'

License

MIT

terminal Tools (25)

Available tools on this MCP server. Each tool can be called directly from any AI agent.

terminal

_ping #1

Verify WhatsApp credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.

terminal

get_business_profile #2

Get the WhatsApp Business profile: name, description, address, email, website, category, and profile picture URL.

terminal

update_business_profile #3

Update WhatsApp Business profile fields. Only provided fields are updated.

terminal

get_phone_number_info #4

Get information about the WhatsApp Business phone number: display number, verified name, quality rating, platform type, and messaging throughput.

terminal

get_account_info #5

Get WhatsApp Business Account (WABA) info: name, currency, timezone, template namespace. Requires WHATSAPP_BUSINESS_ACCOUNT_ID secret.

terminal

send_text #6

Send a text message to a WhatsApp user. Only works within 24h of the user messaging you (session window). For outbound contact use send_template.

terminal

send_image #7

Send an image message. Provide either image_url (publicly accessible HTTPS URL) or media_id from upload_media. Optional caption.

terminal

send_document #8

Send a document/file message. Provide either document_url or media_id. Supports PDF, DOCX, XLSX, and other document types.

terminal

send_video #9

Send a video message. Provide either video_url or media_id. Supports MP4 format.

terminal

send_audio #10

Send an audio message or voice note. Provide either audio_url or media_id. Supports MP3 and OGG formats.

terminal

send_location #11

Send a location pin message with coordinates and optional place name/address.

terminal

send_reaction #12

React to a received message with an emoji. The message_id must be the ID of the received message you want to react to.

terminal

send_buttons #13

Send an interactive message with up to 3 quick-reply buttons. Users tap a button instead of typing. Great for confirmations, choices, and surveys.

terminal

send_list #14

Send an interactive list message. Users tap a button to open a scrollable list of options organized in sections. Max 10 rows total.

terminal

send_cta_url #15

Send an interactive Call-to-Action message with a URL button. Users tap the button to open a URL.

terminal

list_templates #16

List all message templates for the WhatsApp Business Account. Filter by status (APPROVED/PENDING/REJECTED/PAUSED). Requires WHATSAPP_BUSINESS_ACCOUNT_ID secret.

terminal

get_template #17

Get full details of a single message template by ID, including components, variables, rejection reason, and quality score.

terminal

send_template #18

Send an approved template message to any WhatsApp user at any time (not limited by 24-hour window). Required for outbound contact and re-engagement.

terminal

create_template #19

Submit a new message template for Meta review (24-48h approval process). Requires WHATSAPP_BUSINESS_ACCOUNT_ID secret.

terminal

delete_template #20

Delete a message template by name. Requires WHATSAPP_BUSINESS_ACCOUNT_ID secret.

terminal

mark_as_read #21

Mark a received message as read, showing blue double-tick to the sender. Use the message_id from the incoming webhook payload.

terminal

delete_message #22

Delete a sent message. Must be done within a time window after sending. Removes the message from the recipient's view.

terminal

upload_media #23

Upload media to WhatsApp servers by providing a public URL. Returns a media_id that can be reused in send_image/send_video/send_document/send_audio.

terminal

get_media_url #24

Get the download URL for a media file received in a webhook. The URL expires in 5 minutes — download immediately.

terminal

delete_media #25

Delete an uploaded media file from WhatsApp servers to free storage.

Details

upgrade Version 0.1.0

gavel License MIT

wifi Transport streamable-http

lock Access Public

category Category API Connectors

terminal Tools 25

language Live Endpoint

https://mcp.aerostack.dev/s/aerostack/mcp-whatsapp

Sub-50ms globally · Zero cold start

Publisher

@aerostack verified

Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.

Frequently asked questions

What is the WhatsApp MCP server and what can it do? +

The WhatsApp MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `get_business_profile`, `update_business_profile`, `get_phone_number_info`, `get_account_info`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.

Is the WhatsApp MCP server hosted, or do I have to run it myself? +

It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.

Which AI agents and editors can use the WhatsApp MCP server? +

Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same WhatsApp MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.

How do I install the WhatsApp MCP server in Claude Desktop? +

Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-whatsapp": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-whatsapp"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.

How do I use the WhatsApp MCP server in Cursor? +

In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-whatsapp", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-whatsapp"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.

Does WhatsApp MCP require authentication? +

Yes. WhatsApp requires authentication. Check the MCP's documentation for the required credentials.

WhatsApp MCP Server — Hosted Api Connectors Integration

description Overview

mcp-whatsapp — WhatsApp Business MCP Server

What You Can Do

Available Tools

Configuration

Quick Start

Add to Aerostack Workspace

Example Prompts

Direct API Call

License

terminal Tools (25)

Details

Publisher

Tags

More in API Connectors

Aerostack Registry

Algolia

Arangodb

Ayrshare

Basecamp

Bigquery

Frequently asked questions