WhatsApp Business MCP. Send texts, media, locations, and buttons via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
WhatsApp Business MCP Server connects your AI agent directly to the WhatsApp Business API. Send everything—free-form text, rich media like documents and videos, location pins, and interactive quick reply buttons—all through conversation.
It lets your agent handle customer interactions 24/7 without you having to manually type anything in a phone app.
What your AI agents can do
Get business profile
Get the WhatsApp Business Profile for this phone number
Mark as read
Provide the raw wamid message ID.
Mark a WhatsApp message as read
Send contact card
Provide contacts as a JSON array with name and phone fields.
Send a contact card via WhatsApp
Sends a free-form conversational text message to a specific user on WhatsApp.
Transmits images, videos, documents, or audio by providing the recipient number and an absolute public file URL.
Sends a message block that includes up to three predefined quick-reply buttons for immediate user choice.
Uses Meta-approved templates to start or revive conversations when the 24-hour customer service window is closed.
Shares a precise map pin, including custom names, to guide users to a physical business address.
Acknowledges a specific incoming message by applying any standard emoji reaction.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
WhatsApp Business: 6 Tools for Messaging & Media Ops
These six tools give your AI agent the ability to manage every type of message—from simple text to complex interactive media—directly through WhatsApp.
019e9aa4get business profile
Get the WhatsApp Business Profile for this phone number
019e9aa4mark as read
Provide the raw wamid message ID. Mark a WhatsApp message as read
019e9aa4send contact card
Provide contacts as a JSON array with name and phone fields. Send a contact card via WhatsApp
019d7622send emoji reaction
Reacts to a specific WhatsApp message with an emoji, given the recipient number, target message ID, and the emoji character.
019d7622send location pin
Sends a physical location pin on the map by requiring only the recipient number and lat/lng coordinates.
019d7622send media message
Transmits an image, video, document, or audio file via a public URL to a specified recipient number and media type.
019d7622send quick reply buttons
Sends up to three quick-reply buttons along with explanatory text for structured user navigation.
019d7622send template message
Sends a Meta-approved Template message, requiring the exact template name and language code, to resume or initiate conversation.
019d7622send text message
Sends a free-form conversational text message to a user by providing their E.164 phone number and the desired message text.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with WhatsApp Business, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This WhatsApp Business MCP Server connects your AI agent right to the WhatsApp Business API. Your client can handle every kind of customer interaction—from simple chats to complex support flows—without you having to touch a phone app or manually type anything. It's pure, direct communication through conversation.
When writing your automation logic, remember that your agent doesn't just send text; it manages rich payloads. You can start by sending basic conversational messages using send_text_message, which takes the user’s E.164 phone number and the free-form message content you want to deliver.
For sharing files or photos, you don't upload them through the server; you point to them. Use send_media_message when your agent needs to transmit an image, video, document, or audio file by providing a public URL and specifying the media type. This capability lets your client share rich content naturally within the chat flow.
To guide users toward specific answers, use structured inputs with send_quick_reply_buttons. Your agent sends a message block that includes up to three predefined buttons along with explanatory text; the user just clicks what they need. It’s way faster than typing out an answer.
When you gotta talk business outside of normal hours, remember that Meta requires templates. You'll use send_template_message which needs the exact template name and language code to either start a new conversation or revive one after the 24-hour window closes. This keeps your support running round the clock.
If you need to guide them physically, send_location_pin lets your agent drop a precise map pin right into the chat. You just provide the recipient’s number and the latitude/longitude coordinates, and it shows up as a clickable location.
Finally, for little maintenance tasks—like letting the user know you saw their message—you can use send_emoji_reaction. This tool lets your agent react to a specific incoming message by applying any standard emoji character, requiring the recipient number, the target message ID, and the desired emoji.
How WhatsApp Business MCP Works
- 1 Subscribe to the WhatsApp Business MCP Server and enter your required access tokens (Access Token, Phone Number ID).
- 2 Your AI agent calls a specific tool (e.g.,
send_media_message), passing structured data like the recipient number, file URL, and media type. - 3 The server processes the API call and sends the fully formatted message—whether it's text or rich media—through WhatsApp.
The bottom line is your agent becomes a communication engine that handles all messaging logic without needing manual interaction with any external phone app.
Who Is WhatsApp Business MCP For?
This is for Ops Engineers and Customer Support Leads who hate the friction of copy-pasting details or manually sending follow-up media. If your team spends time managing conversation flow across different channels, you need this. It lets your agent handle complex communications—like sending a document and suggesting a meeting location—in one chat.
Responds to user questions by instantly fetching and attaching helpful documents or sharing the nearest store location using send_media_message and send_location_pin.
Follows up with leads who haven't responded. They use approved templates via send_template_message to provide product media or book a demo time.
Automates notification broadcasts and manages user flow by sending quick-reply buttons (send_quick_reply_buttons) after initial contact.
What Changes When You Connect
- Never manually send follow-ups again. Use
send_template_messageto hit leads outside business hours or initiate contact with a specific goal. - Stop losing context when sending files.
send_media_messagehandles all rich content—images, PDFs, videos—by using public URLs and attaching them directly in the chat history. - Improve user flow immediately. Instead of long text replies, use
send_quick_reply_buttonsto give users three immediate options (e.g., 'Yes', 'No', 'Talk to Agent'). - Pinpoint customers better. When a client asks for directions, the agent calls
send_location_pin, sharing an accurate map pin with custom naming. - Manage communication scaling automatically. The server handles outbound messaging using professional WhatsApp infrastructure, letting your AI agent do the heavy lifting.
Real-World Use Cases
The Support Agent needs to guide a user to a store.
A customer asks where the nearest branch is. The support agent doesn't copy/paste Google Maps links; instead, their agent calls send_location_pin, instantly sending a clickable map pin right in the chat. This saves time and eliminates confusing link clicks.
The Sales Team needs to follow up with a lead after hours.
A prospect hasn't responded all day. The sales agent uses send_template_message with an approved 'followup' template, sending product media and prompting them for next steps—all without violating WhatsApp policy or waiting until 9 AM.
The Marketing team needs to confirm service selection.
A user chats in about services. The agent doesn't just write a list; it uses send_quick_reply_buttons with options like 'Billing', 'Technical Support', and 'Sales'. The user clicks the button, guiding the conversation instantly.
The Operations team needs to document an issue.
An agent receives a complex inquiry. They use send_media_message to attach a supporting document (a PDF guide) and simultaneously use send_text_message to summarize the next steps, keeping all context together.
The Tradeoffs
Sending large files directly
Trying to upload a document or video file from your local machine into the agent call. This will fail because the API requires public URLs.
→
You must use send_media_message. Always pass an absolute, publicly accessible URL for the media payload, like https://yourdomain.com/path/to/file.pdf.
Sending messages after hours without templates
Attempting to send a free-form text message (via send_text_message) at 2 AM. WhatsApp will block it because it's outside the 24-hour window and isn't templated.
→
For communication outside business hours, always use send_template_message with a Meta-approved template name to resume contact.
Asking for user choice via long text blocks
Writing 'Do you want A or B or C?' in the agent prompt. This is clunky and forces the user to read and type out their choice.
→
Use send_quick_reply_buttons. Provide a clear explanation, then pass an array of up to three button labels (e.g., ['Yes', 'No', 'Maybe']) for instant selection.
When It Fits, When It Doesn't
Use this server if your primary need is high-volume, structured customer communication that requires rich content and works outside standard business hours. If you rely on sending documents, location data, or needing to guide users through a defined choice set (e.g., 'Billing' vs. 'Support'), these tools are critical.
Don't use this if your primary need is just internal team messaging or simple SMS alerts—those systems will be easier. Also, don't expect the server to magically format complex interactive carousels; you have to build that flow using the specific combination of send_quick_reply_buttons and structured text.
If your workflow involves 'read a document > confirm location > start conversation,' this suite handles it end-to-end. If it's just simple one-way broadcasting, check if a dedicated notification service is simpler.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 9 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Sending rich media and complex messages used to mean jumping between tools.
If your agent needs to send a guide (a PDF), then share the store map (coordinates), and *then* confirm the booking via text, you’re running multiple manual steps. You have to check three different inputs, copy the file link, look up the coordinates, and write out the confirmation message. It's slow.
Now, your agent handles it in one flow. The workflow passes all that data—the public URL for the PDF, the lat/lng pair for the map pin, and the final text summary—to the MCP server. You get a single, unified response: the user sees everything they need right there.
The WhatsApp Business MCP Server lets you manage conversations with precise tools.
You no longer have to worry about what message format is needed for a specific action. Do you need to initiate contact after hours? Use `send_template_message`. Need the user to pick an option instantly? Call `send_quick_reply_buttons` instead of writing out a list.
It's not just sending text; it’s sending context. It keeps your agent conversationally accurate, whether you're confirming details with `send_text_message` or sharing media via `send_media_message`. Period.
Common Questions About WhatsApp Business MCP
How do I send a file using the send_media_message tool? +
You must provide an absolute, publicly accessible URL for the content. You pass this URL and specify the media type (e.g., 'image' or 'document') to the send_media_message tool.
Can I send a message outside of WhatsApp business hours? +
Yes, but you can't use regular text messages. You must call send_template_message with an approved template name and language code to resume the conversation legally.
What is required for the send_quick_reply_buttons tool? +
You need to provide a short explanation text, along with a comma-separated list of up to three button labels. The user clicks these buttons, which drives the conversation flow.
Does the WhatsApp Business MCP Server support live chat messages? +
It supports free-form conversational messaging using send_text_message within the 24-hour service window. This is for natural, back-and-forth chatting.
Can I send a map pin with send_location_pin? +
Yes. The tool accepts both the recipient number and the latitude/longitude coordinates to pinpoint an exact physical location on the map.
If my WhatsApp Access Token expires, how do I reauthenticate for tools like send_text_message? +
You must update your access token directly within the Vinkius Marketplace settings. Once saved, manually trigger a server refresh or test call. The agent will then use the new credentials for all subsequent messages.
What happens if I try to send media using the send_media_message tool with an invalid URL? +
The API rejects the request immediately and returns a specific error code indicating the resource was not found. You must validate that the provided absolute file URL is publicly accessible before calling this function.
Are there rate limits when I use multiple tools like send_text_message or send_emoji_reaction? +
Yes, WhatsApp enforces usage caps to prevent spam. If your agent sends messages too quickly, you will hit a rate-limit error. You'll need to build backoff logic into your client code for reliable operation.
Can I send a message to a customer who hasn't messaged me in the last 24 hours? +
Yes, but you must use the send_template_message tool. WhatsApp requires Meta-approved templates to initiate contact outside the 24-hour service window. For active conversations within that window, you can use the send_text_message tool for free-form replies.
How many quick-reply buttons can I send at once? +
Using the send_quick_reply_buttons tool, you can send up to 3 interactive buttons along with a message block. This is ideal for helping users choose between options like 'Confirm', 'Cancel', or 'Reschedule' with a single tap.
Can I share images or PDF documents through this server? +
Absolutely. Use the send_media_message tool and provide a public URL to your asset. You can specify the type as 'image' or 'document' and even add a custom caption to the message.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Slack
Automate Slack messaging — send messages, search conversations, list channels and users directly from any AI agent.
Clickatell
Manage mobile messaging via Clickatell — send SMS, track delivery status, monitor balance, and handle inbound rules directly from any AI agent.
Discord Bot
Control and manage your Discord bots — audit guilds, channels, and messages via AI.
You might also like
Apple App Store
Manage your iOS apps and TestFlight builds with Apple App Store Connect — track reviews, versions, and sales via AI.
Knorish
Launch your online school and sell courses with a platform that bundles LMS, website builder, and payment processing together.
Plecto
Automate KPI dashboards and data tracking via Plecto — manage registrations, dashboards, and teams directly from any AI agent.