How to Use the WhatsApp Business MCP in Windsurf

Q: How does Windsurf handle WhatsApp Business messaging templates?

Windsurf uses the sendtemplatemessage tool to send Meta-approved message formats. You just supply the exact template name and language code, and the agent handles the rest of the delivery process.

Q: Can Windsurf use WhatsApp Business for sending contact cards?

Yes. The sendcontactcard tool lets your agent send structured contact information via a JSON array containing names and phone numbers. It's perfect for follow-up steps in a workflow.

Q: How do I verify if WhatsApp Business supports location sharing with Windsurf?

The sendlocationpin tool confirms support. You provide the target recipient number and the required lat/lng coordinates, and your agent sends a physical pin directly on WhatsApp Business.

Automate WhatsApp Business workflows: Use Windsurf to chain multi-step messaging actions autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WhatsApp Business MCP to Windsurf

Create your Vinkius account to connect WhatsApp Business to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup WhatsApp Business with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Send templated or free text messages.

You need to start a conversation? The `send_template_message` tool sends Meta-approved templates, which is required for initiating contact with WhatsApp Business. Alternatively, use `send_text_message` to send plain conversational text when you know the user. These actions allow your agent to handle complex outreach flows without needing manual input at every stage.

Handle media and location sharing.

Sending files is simple. Use `send_media_message` with a public URL—it handles images, videos, documents, or audio. Need to pinpoint something? The `send_location_pin` tool drops precise lat/lng coordinates directly onto the map for WhatsApp Business. This gives your autonomous agent the ability to communicate rich media contextually.

React and manage conversation state.

Sometimes you just need a quick acknowledgement. You can react to a specific message using `send_emoji_reaction`, provided you have the raw `wamid` ID. Also, if your workflow requires it, `mark_as_read` lets your agent update the status of a conversation thread. The MCP Server handles these small but necessary state changes for multi-step tasks.

Setup guide

Set up WhatsApp Business MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the WhatsApp Business MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my WhatsApp Business payment history." If connected, Cascade will call the WhatsApp Business tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "whatsapp-business-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by WhatsApp Business. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect WhatsApp Business now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about WhatsApp Business MCP in Windsurf

Windsurf uses the `send_template_message` tool to send Meta-approved message formats. You just supply the exact template name and language code, and the agent handles the rest of the delivery process.

Yes. The `send_contact_card` tool lets your agent send structured contact information via a JSON array containing names and phone numbers. It's perfect for follow-up steps in a workflow.

This server touches user identifiers, specifically E.164 phone numbers and message content. All actions are governed by your endpoint token, ensuring that only authorized workflows can interact with this MCP Server.

The MCP Server manages the connection to WhatsApp Business directly. Since Windsurf chains actions autonomously, it reliably executes sequential messages and media sends without requiring you to prompt each individual step.

The `send_location_pin` tool confirms support. You provide the target recipient number and the required lat/lng coordinates, and your agent sends a physical pin directly on WhatsApp Business.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript