1msg.io MCP. Control WhatsApp messaging from your AI agent.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
1msg.io MCP Server. Connect your AI agent directly to the official WhatsApp Business API. Use this to send text, media, and template messages, manage pre-approved templates, and check your channel's connection status.
It handles all official Meta standards, letting your agent manage customer support and broadcasts without leaving your chat client.
What your AI agents can do
Get status
Checks the current connection status of the 1msg.io WhatsApp channel.
List messages
Retrieves a history of recent incoming and outgoing WhatsApp messages.
List templates
Lists all pre-approved WhatsApp message templates available for sending.
Run get_status to confirm if your WhatsApp channel is connected, connecting, or disconnected.
Use send_message or send_file to send simple text or attach media (PDF, image, video) to a recipient's WhatsApp chat.
Execute send_template to send structured messages using templates that Meta has pre-approved.
Call list_templates to see all the pre-approved templates you can send via WhatsApp.
Run list_messages to pull a log of recent incoming and outgoing WhatsApp messages for context.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
1msg.io MCP Server: 6 Tools for WhatsApp Messaging
Use these tools to manage WhatsApp status, send messages, handle files, and manage official templates directly through your AI client.
019d7541get status
Checks the current connection status of the 1msg.io WhatsApp channel.
019d7541list messages
Retrieves a history of recent incoming and outgoing WhatsApp messages.
019d7541list templates
Lists all pre-approved WhatsApp message templates available for sending.
019d7541send file
Sends a media file (image, PDF, video) to a specified WhatsApp number.
019d7541send message
Sends a simple text message to a WhatsApp recipient number.
019d7541send template
Sends a structured message using a pre-approved WhatsApp template name.
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 1msg.io, 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
Connect your AI agent directly to the official WhatsApp Business API using this server. You'll use it to send text, media, and template messages, manage pre-approved templates, and check your channel's connection status. It handles all of Meta's official standards, letting your agent manage customer support and broadcasts without leaving your chat client.
Checking Status and History
Run get_status to confirm if your WhatsApp channel is connected, connecting, or disconnected. You'll use list_messages to pull a log of recent incoming and outgoing WhatsApp messages for context.
Sending Messages
Send a simple text message to a recipient's WhatsApp chat with send_message. You can send a media file—like an image, PDF, or video—to a specified number using send_file. For structured messages, execute send_template using a pre-approved WhatsApp template name. You'll first call list_templates to see all the pre-approved templates you can send via WhatsApp.
How 1msg.io MCP Works
- 1 First, subscribe to the server and provide your 1msg.io JWT Token.
- 2 Next, your AI client uses the MCP to call a specific tool (e.g.,
send_message) with the necessary recipient number and content. - 3 The server executes the tool against the 1msg.io API, sending the message or retrieving the data, and passes the result back to your AI client.
The bottom line is that your AI agent talks to the 1msg.io API, and the server handles the connection details.
Who Is 1msg.io MCP For?
The Ops Engineer who needs to track message delivery rates. The Customer Support Manager who can't afford manual responses. Marketing leads needing to run broadcast campaigns that follow official Meta rules. Any team that needs to use WhatsApp as a reliable, programmable channel.
Uses this to automatically respond to common customer inquiries and send help guides directly on WhatsApp.
Monitors the channel status using get_status and tracks delivery rates via list_messages to keep communications reliable.
Automates broadcast notifications and lead follow-ups using pre-approved templates and file attachments.
What Changes When You Connect
- Audit conversations with
list_messages: Stop relying on scattered email logs. Use this tool to pull a centralized history of recent WhatsApp messages, giving your agent full context for follow-up replies. - Guarantee compliance with
send_template: Never risk sending a message that violates Meta's rules. By usingsend_template, your agent ensures all broadcast and initiation messages use pre-approved, official formats. - Handle complex media with
send_file: Sending a PDF or image shouldn't require a separate system call.send_filelets your agent attach any media type to a conversation flow seamlessly. - Maintain connection health with
get_status: Before running a critical campaign, check the connection status.get_statusconfirms your WhatsApp instance is 'connected' and ready to send messages. - Automate lead follow-up with
send_message: Instead of manual follow-up, your agent can executesend_messageto send quick, personalized text updates to leads on their preferred platform. - Manage outgoing formats with
list_templates: Before sending a template, runlist_templatesto confirm the exact name and parameters needed. This prevents your agent from failing due to a misspelled template name.
Real-World Use Cases
A Support Ticket Needs Context
A user contacts support via WhatsApp. The agent first runs list_messages to pull the last 10 exchanges. It sees the customer mentioned a specific invoice. The agent then uses send_file to send the PDF invoice directly to the chat, solving the query without the human needing to switch apps.
Running a Compliance Broadcast
The marketing team needs to notify 500 users about a policy change. The agent runs list_templates to confirm the official template name. It then executes send_template to send the broadcast, ensuring every message adheres to WhatsApp's required structure.
Checking Campaign Readiness
An operations manager needs to know if the messaging system is up. They ask their agent to run get_status. If the status isn't 'connected', the agent stops and alerts the manager, preventing a failed, costly campaign.
Sales Follow-Up After a Meeting
After a sales call, the agent drafts a summary. It uses send_message to send the summary text, and then uses send_file to attach the signed PDF contract, keeping the entire interaction on WhatsApp.
The Tradeoffs
Treating WhatsApp like Email
Trying to send a general update using send_message when a specific format is required. This will fail or violate Meta rules because the API expects a structured template.
→
Always use send_template for any broadcast or conversation initiation. First, run list_templates to find the correct template name, then execute send_template.
Forgetting the connection status
Running a large campaign using send_message right after a system update, assuming connectivity. The campaign fails silently or times out because the channel is disconnected.
→
Always start by calling get_status. If it doesn't return 'connected,' don't send anything. Wait until the status is confirmed.
Sending files without context
The agent tries to send a file to a number without knowing the recent conversation. The recipient is confused, and the conversation lacks context.
→
First, run list_messages to retrieve the chat history. Then, use send_file to attach the document, referencing the context found in the message logs.
When It Fits, When It Doesn't
Use this server if your primary communication channel is WhatsApp and you need your AI agent to manage it like a first-class service. You need to send media, run automated campaigns, and track logs all within one place. Don't use it if you only need to send simple text messages to a single, known endpoint and don't care about templates or history—a basic SMS gateway might suffice. But if you care about official compliance and auditing, this is the tool. It forces you to respect Meta's structure, which is exactly what you need for reliable operations.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by 1msg.io. 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 6 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Managing WhatsApp messaging usually means jumping between three different dashboards: the CRM, the messaging platform, and the template library.
Today, to send a compliant broadcast, you might have to open your CRM, check the recipient list; then jump to the messaging platform to see the connection status; and finally, log into a separate template management system just to get the right API name. Copying names, checking status, and piecing together the sequence takes time and introduces failure points.
With the 1msg.io MCP Server, your agent handles the whole flow. You tell it, 'Send the invoice.' It automatically checks the connection with `get_status`, finds the right template using `list_templates`, and sends the final message using `send_template`—all from a single chat prompt.
1msg.io MCP Server: Run full WhatsApp workflows from your agent.
Manual workflows involve checking the connection status and then manually listing templates to ensure the message is compliant. You then have to manually upload and track the delivery of media via a different dashboard.
Now, your AI client handles the complexity. You simply ask your agent to 'Follow up on the invoice.' The agent coordinates the status check, pulls the PDF via `send_file`, and sends the whole package using the right tool sequence. It's reliable, and it’s all in one place.
Common Questions About 1msg.io MCP
How do I check if the 1msg.io MCP Server is working? +
Run the get_status tool. This immediately tells you if your WhatsApp instance is 'connected,' 'connecting,' or 'disconnected,' confirming your agent can send messages.
Can I send a PDF using the 1msg.io MCP Server? +
Yes, use send_file. This tool handles media types like images, PDFs, and videos, sending them to the recipient's WhatsApp chat.
What is the difference between `send_message` and `send_template`? +
Use send_message for simple, ad-hoc text. Use send_template when you need to initiate a conversation or broadcast, as templates ensure you comply with WhatsApp's rules.
How do I find out what templates I can use with 1msg.io MCP Server? +
Call list_templates. This tool retrieves a list of all pre-approved message templates you have access to on the 1msg.io platform.
When I use the `list_messages` tool, what kind of message history can I retrieve from 1msg.io MCP Server? +
The list_messages tool retrieves both incoming and outgoing WhatsApp message history. This lets you audit conversations and maintain full context for your agent.
How does the `send_template` tool handle the mandatory pre-approval requirement for WhatsApp? +
The send_template tool only sends templates that have been pre-approved by Meta. This ensures your communications adhere to official WhatsApp standards.
Is there a way to check the operational status using the `get_status` tool with 1msg.io MCP Server? +
Yes, running get_status checks the live connection status of your 1msg.io WhatsApp channel. It confirms if your automation is connected, connecting, or disconnected.
What information does `list_templates` provide about available WhatsApp templates? +
list_templates provides a list of all WhatsApp templates available on your account. You use this list to ensure the template name passed to send_template is correct.
Why do I need to use templates to send a message? +
WhatsApp requires the use of pre-approved templates for any message initiated by the business or sent after 24 hours of the last customer interaction. This prevents spam and ensures high-quality communications.
Can I send PDF documents or images via the agent? +
Yes! Use the send_file tool and provide the recipient's number and the public URL of the document or image. Your agent will handle the formatting and delivery automatically.
How can I check if my WhatsApp channel is currently online? +
Use the get_status tool. It returns the current state of your 1msg.io instance (e.g., connected, connecting, or disconnected). This is crucial for monitoring your automation health.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
WeChat Mini-Programs / 微信小程序
China's dominant mini-app ecosystem — manage users, phone numbers, and messaging via AI.
Twilio SMS Sender
This MCP does exactly one thing: it sends raw SMS messages using Twilio. That's its only function, and nothing else. Incredible for giving your AI agents out-of-band alerting capabilities.
Front
Manage shared inboxes, track conversations, and collaborate on emails via AI agents with Front.
You might also like
Infisical
Manage secrets infrastructure via AI — list, create, update, and audit secrets across environments with end-to-end encryption.
CAMB.AI
Translate and dub audio content into dozens of languages using AI voices that sound natural and preserve speaker identity.
Craft CMS (Craftnet)
Equip your AI agent to manage plugins, licenses, and sales directly via the Craftnet (Craft CMS) API.