Use WhatsApp Channels with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Post text and media to WhatsApp Channels from any AI agent. create channels, publish posts, search public channels and read their feed.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 8 capabilities
The complete WhatsApp Channels capability set.
These are the exact actions your AI can choose when you ask it to work with WhatsApp Channels.
01-04
4 capabilities in this set.
Part of 8 available through WhatsApp Channels.
- 01
Get channel messages
Page back in history with before_timestamp set to the oldest timestamp of the previous page; page forward with after_timestamp set to the newest one seen. The channel must be one your number follows. otherwise use get_channel_preview. Read posts from a channel you are subscribed to, newest first
- 02
Get channel preview
Pass the invite code from a whatsapp.com/channel/<CODE> link or the @newsletter id. Only the preview window is visible; use get_channel_messages for full history of channels you follow. Preview the latest posts of any public channel without subscribing to it
- 03
Get channel
Accepts either a full channel id ("120363...@newsletter") or the invite code. the last path segment of a https://whatsapp.com/channel/<CODE> link. Use it to check subscriber reach before or after posting. Get one channel profile by newsletter id or invite code, including subscriber count
- 04
List channels
Use it first to find the @newsletter channel id needed for posting; filter with role=OWNER or role=ADMIN. subscribers cannot post. List WhatsApp Channels linked to the logged-in number (owned, administered or subscribed)
05-08
4 capabilities in this set.
Part of 8 available through WhatsApp Channels.
- 05
Post channel media
File_url must be publicly downloadable. WAHA downloads it server-side before posting. For image/video the optional caption appears under the media; voice posts ignore captions. Requires role OWNER or ADMIN; channel_id ends with "@newsletter". Publish an image, video or voice post to a WhatsApp Channel from a public file URL
- 06
Post channel text
Requires your role OWNER or ADMIN on the channel. subscribers cannot post. channel_id must end with "@newsletter" (get it from list_channels). Supports normal WhatsApp text formatting; emoji included as-is. Publish a text post to a WhatsApp Channel you own or administer
- 07
Search channels
Paginate with start_cursor using the endCursor from the previous response (recommended limit 50). Useful to monitor competitors or find a channel before subscribing. Discover public WhatsApp Channels by keyword (like the in-app explore search)
- 08
Create channel
The WAHA session must use the NOWEB, WPP or GOWS engine. the default WEBJS engine cannot create channels (posting to an existing channel still works on WEBJS). Keep the name short and unique. Optionally attach a profile picture from any public image URL. Create a new WhatsApp Channel owned by the logged-in number
One connector, every AI
WhatsApp Channels works with the most popular AI clients.
These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.
Claude
ChatGPT
Gemini
Perplexity
Grok
Microsoft Copilot
Cursor
VS Code
Windsurf
JetBrains
Cline
LangChain
Vercel AI SDK
Lovable
Z.ai
Raycast
Qwen Code
Kimi Code
Le ChatBuilding your own app? The connector is yours to use.
You don't need a client to put WhatsApp Channels to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 8 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of WhatsApp Channels, so you can see the experience inside your AI.
It does not authenticate your account with WhatsApp Channels. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
WhatsApp Channels Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_5K57i1fMlwpder7E03mDPWA5PbxgzbY5bXi9TCnR/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — WhatsApp Channels capabilities are ready to use.
{
"mcpServers": {
"whatsapp-channels-mcp": {
"url": "https://edge.vinkius.com/vk_preview_5K57i1fMlwpder7E03mDPWA5PbxgzbY5bXi9TCnR/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
Guided setup for Claude? How to give Claude access to WhatsApp Channels
FAQ
Questions WhatsApp Channels owners ask.
- 01
What is WAHA and why do I need it?
WAHA is the WhatsApp API server this connector talks to. a free open-source app you run in Docker on your own infrastructure. It keeps your WhatsApp session under your control: no third party ever sees your messages or credentials.
- 02
What do I need to set up before first post?
Run WAHA on a VPS bound to 127.0.0.1:3000 (docker run -p 127.0.0.1:3000:3000 -e WAHA_API_KEY=secret devlikeapro/waha) and expose it over HTTPS via a reverse proxy (Caddy/Nginx/Traefik) on your own domain. Open WAHA's dashboard at that HTTPS URL, start a session, scan the QR code with the phone that owns your channel, then set WAHA_BASE_URL (https://...) and WAHA_API_KEY in this server's credentials.
- 03
Why do my posts fail with a permissions error?
Only owners and admins can publish to a channel. subscribers cannot. Run list_channels to check your role, and make sure the channel id you pass ends with @newsletter.
- 04
Is my WhatsApp account safe using WAHA?
WAHA is self-hosted, so your session stays on your own server and never touches a third party. It emulates WhatsApp Web, which is outside WhatsApp's official terms. keep posting volume human-like (a few broadcast posts, not spam) to minimise restriction risk.
Explore
More in Marketing
Wati AI Connector
Send WhatsApp messages at scale with official API access, chatbot automation, and shared team inbox for busine
ViewWbiztool AI Connector
Manage your WhatsApp Business account with bulk messaging, contact management, and campaign analytics for mark
ViewDoubleTick AI Connector
Scale your WhatsApp sales with bulk messaging, chatbot automation, and team inbox features built for growing b
ViewTexter AI Connector
Send automated text messages and run SMS drip campaigns that engage leads and customers with timely follow-ups
View
Suggestions
Saysimple AI Connector
Automate omnichannel messaging via Saysimple — manage chats, send WhatsApp/SMS, and use templates with AI.
ViewWA Smart Business AI Connector
Automate WhatsApp marketing and communication via WA Smart Business — manage contacts, groups, and messages di
ViewPubNub (Real-time Messaging) AI Connector
Enable real-time messaging, presence tracking, and message history for your AI agent using PubNub's global dat
ViewQuickReply.ai AI Connector
Automate WhatsApp marketing and customer engagement via QuickReply.ai — trigger journeys, send templates, and
View

