Summary
Connects your AI coding environment to the WhatsApp Business API so you can send messages, templates, and media directly from Cursor or Claude Code. Exposes six core operations: send text messages, send template messages, send media files, run broadcast campaigns, register webhooks, and manage contacts. You authenticate with a Gavi WhatsApp API key and then just ask your AI to send messages, which it handles through their REST endpoints. Useful when you're building notification systems, customer support flows, or marketing automation and want to test or trigger WhatsApp sends without leaving your editor. Requires a paid Gavi WhatsApp subscription starting at $9.99/month plus Meta's per-message fees.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
55 tools
manycontacts.contextGet ManyContacts account overview: WhatsApp Business channels, contact/user/tag counts, active AI agents, and enabled features. Use this first to understand the account state.
Get ManyContacts account overview: WhatsApp Business channels, contact/user/tag counts, active AI agents, and enabled features. Use this first to understand the account state.
No parameter schema in public metadata yet.
manycontacts.contacts.listList WhatsApp Business contacts with filters (tags, team, date, unread, blacklist, scheduled). Returns paginated results.12 params
List WhatsApp Business contacts with filters (tags, team, date, unread, blacklist, scheduled). Returns paginated results.
Parameters* required
openstringFilter by open/closed status: 'true' or 'false'
pagenumberPage number (default 1)
tagsstringComma-separated tag IDs (contacts must have ALL tags)
teamstringFilter by team ID
limitnumberResults per page, max 200 (default 50)
stagesstringComma-separated funnel stage IDs
unreadstringSet to 'true' for only contacts with unread messages
date_tostringFilter updated before date (YYYY-MM-DD, max 90 days range)
blackliststringSet to 'true' for only blacklisted contacts
date_fromstringFilter updated after date (YYYY-MM-DD)
scheduledstringSet to 'true' for only contacts with pending scheduled messages
assigned_tostringFilter by assigned user ID
manycontacts.contacts.getGet detailed information about a WhatsApp Business contact including tags, teams, and funnel stages.1 params
Get detailed information about a WhatsApp Business contact including tags, teams, and funnel stages.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
manycontacts.contacts.createCreate a new WhatsApp Business contact in ManyContacts CRM.3 params
Create a new WhatsApp Business contact in ManyContacts CRM.
Parameters* required
namestringContact display name
notesstringInternal notes about the contact
phonestringPhone number with country code, e.g. 34600000000
manycontacts.contacts.updateUpdate an existing WhatsApp Business contact (name, notes, custom fields).4 params
Update an existing WhatsApp Business contact (name, notes, custom fields).
Parameters* required
namestringNew contact name
notesstringNew contact notes
phonestringPhone number with country code, e.g. 34600000000
customFieldsstringCustom fields as JSON string
manycontacts.contacts.deleteDelete a WhatsApp Business contact from ManyContacts CRM.1 params
Delete a WhatsApp Business contact from ManyContacts CRM.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
manycontacts.contacts.assignAssign a WhatsApp Business contact to a team member.2 params
Assign a WhatsApp Business contact to a team member.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
userIdstringUser ID to assign the contact to
manycontacts.contacts.unassignUnassign a WhatsApp Business contact (remove current user assignment).1 params
Unassign a WhatsApp Business contact (remove current user assignment).
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
manycontacts.contacts.closeClose a WhatsApp Business conversation.1 params
Close a WhatsApp Business conversation.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
manycontacts.contacts.openReopen a closed WhatsApp Business conversation.1 params
Reopen a closed WhatsApp Business conversation.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
manycontacts.contacts.tag.addAdd a tag to a WhatsApp Business contact.2 params
Add a tag to a WhatsApp Business contact.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
tagIdstringTag ID to add
manycontacts.contacts.tag.removeRemove a tag from a WhatsApp Business contact.2 params
Remove a tag from a WhatsApp Business contact.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
tagIdstringTag ID to remove
manycontacts.contacts.team.addAdd a team to a WhatsApp Business contact.2 params
Add a team to a WhatsApp Business contact.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
teamIdstringTeam ID to add
manycontacts.contacts.team.removeRemove a team from a WhatsApp Business contact.2 params
Remove a team from a WhatsApp Business contact.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
teamIdstringTeam ID to remove
manycontacts.contacts.set_stageMove a WhatsApp Business contact to a funnel/pipeline stage.3 params
Move a WhatsApp Business contact to a funnel/pipeline stage.
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
stage_idstringStage ID within the funnel
funnel_idstringFunnel ID
manycontacts.contacts.bulkPerform bulk operations on multiple WhatsApp Business contacts (close, open, assign, add_tag, add_team).3 params
Perform bulk operations on multiple WhatsApp Business contacts (close, open, assign, add_tag, add_team).
Parameters* required
valuestringValue for action (user_id for assign, tag_id for add_tag, team_id for add_team)
actionstringBulk action: close, open, assign, add_tag, or add_team
phonesstringComma-separated phone numbers
manycontacts.messages.listList WhatsApp Business messages for a contact. Shows the conversation history with timestamps and status.3 params
List WhatsApp Business messages for a contact. Shows the conversation history with timestamps and status.
Parameters* required
pagenumberPage number (default 1)
limitnumberMessages per page (default 50)
phonestringPhone number with country code, e.g. 34600000000
manycontacts.messages.send.textSend a WhatsApp Business text message to a phone number.2 params
Send a WhatsApp Business text message to a phone number.
Parameters* required
bodystringMessage text to send
phonestringPhone number with country code, e.g. 34600000000
manycontacts.messages.send.noteSend an internal note on a WhatsApp Business contact (not visible to the contact).2 params
Send an internal note on a WhatsApp Business contact (not visible to the contact).
Parameters* required
bodystringInternal note text
phonestringPhone number with country code, e.g. 34600000000
manycontacts.messages.send.templateSend a WhatsApp Business template message (for outbound messaging outside the 24h window).3 params
Send a WhatsApp Business template message (for outbound messaging outside the 24h window).
Parameters* required
phonestringPhone number with country code, e.g. 34600000000
variablesstringTemplate variables as JSON array, e.g. '["John","20%"]'
templateIdstringTemplate ID to send
manycontacts.templates.listList WhatsApp Business message templates. Templates are required for sending messages outside the 24h conversation window.1 params
List WhatsApp Business message templates. Templates are required for sending messages outside the 24h conversation window.
Parameters* required
statusstringFilter by template status: approved, pending, or rejected
manycontacts.templates.getGet details of a specific WhatsApp Business message template including components and configuration.1 params
Get details of a specific WhatsApp Business message template including components and configuration.
Parameters* required
idstringTemplate ID
manycontacts.templates.syncSync WhatsApp Business templates from Meta Cloud API. Fetches the latest templates from the connected WhatsApp Business account.
Sync WhatsApp Business templates from Meta Cloud API. Fetches the latest templates from the connected WhatsApp Business account.
No parameter schema in public metadata yet.
manycontacts.campaigns.listList WhatsApp Business bulk messaging campaigns with statistics (sent, delivered, read, failed counts).
List WhatsApp Business bulk messaging campaigns with statistics (sent, delivered, read, failed counts).
No parameter schema in public metadata yet.
manycontacts.campaigns.createCreate a WhatsApp Business bulk messaging campaign. Sends a template message to a list of phone numbers at a scheduled time.5 params
Create a WhatsApp Business bulk messaging campaign. Sends a template message to a list of phone numbers at a scheduled time.
Parameters* required
datestringScheduled send date in ISO format, e.g. 2026-12-01T09:00:00
namestringCampaign name
phonesstringComma-separated phone numbers to send to
variablesstringTemplate variables as JSON array, e.g. '["John","20%"]'
templateIdstringWhatsApp template ID to use
manycontacts.campaigns.deleteDelete a WhatsApp Business campaign.1 params
Delete a WhatsApp Business campaign.
Parameters* required
idstringCampaign ID to delete
manycontacts.org.getGet WhatsApp Business organization/account information (name, timezone, settings).
Get WhatsApp Business organization/account information (name, timezone, settings).
No parameter schema in public metadata yet.
manycontacts.org.updateUpdate WhatsApp Business organization settings (timezone, auto-reply, webhooks, etc.).10 params
Update WhatsApp Business organization settings (timezone, auto-reply, webhooks, etc.).
Parameters* required
timezonestringTimezone, e.g. Europe/Madrid
auto_reply_awaybooleanEnable away auto-reply
auto_reply_openbooleanEnable auto-reply on chat open
auto_reply_closebooleanEnable auto-reply on chat close
webhooks_forwardbooleanEnable webhook forwarding
auto_reply_away_textstringAway auto-reply text
auto_reply_open_textstringAuto-reply text when chat opens
webhooks_forward_urlstringWebhook forward URL
auto_reply_close_textstringAuto-reply text when chat closes
auto_reply_close_minutesnumberMinutes before auto-close
manycontacts.org.schedule.getGet the business hours schedule for the WhatsApp Business account.
Get the business hours schedule for the WhatsApp Business account.
No parameter schema in public metadata yet.
manycontacts.org.apikeyGet the organization API key.
Get the organization API key.
No parameter schema in public metadata yet.
manycontacts.channels.listList connected WhatsApp Business and Instagram channels.
List connected WhatsApp Business and Instagram channels.
No parameter schema in public metadata yet.
manycontacts.tags.listList all tags for categorizing WhatsApp Business contacts.
List all tags for categorizing WhatsApp Business contacts.
No parameter schema in public metadata yet.
manycontacts.tags.createCreate a new tag for WhatsApp Business contacts.2 params
Create a new tag for WhatsApp Business contacts.
Parameters* required
namestringTag name
colorstringTag color hex, e.g. #ff0000 (default #fab1a0)
manycontacts.tags.updateUpdate an existing WhatsApp Business contact tag.3 params
Update an existing WhatsApp Business contact tag.
Parameters* required
idstringTag ID
namestringNew tag name
colorstringNew tag color hex
manycontacts.tags.deleteDelete a WhatsApp Business contact tag.1 params
Delete a WhatsApp Business contact tag.
Parameters* required
idstringTag ID to delete
manycontacts.teams.listList teams in the WhatsApp Business organization.
List teams in the WhatsApp Business organization.
No parameter schema in public metadata yet.
manycontacts.teams.createCreate a new team in the WhatsApp Business organization.1 params
Create a new team in the WhatsApp Business organization.
Parameters* required
namestringTeam name
manycontacts.teams.add_memberAdd a user to a team.2 params
Add a user to a team.
Parameters* required
teamIdstringTeam ID
userIdstringUser ID to add
manycontacts.teams.remove_memberRemove a user from a team.2 params
Remove a user from a team.
Parameters* required
teamIdstringTeam ID
userIdstringUser ID to remove
manycontacts.teams.deleteDelete a team from the WhatsApp Business organization.1 params
Delete a team from the WhatsApp Business organization.
Parameters* required
idstringTeam ID to delete
manycontacts.funnels.listList sales funnels/pipelines for organizing WhatsApp Business contacts by stage.
List sales funnels/pipelines for organizing WhatsApp Business contacts by stage.
No parameter schema in public metadata yet.
manycontacts.funnels.createCreate a new sales funnel/pipeline for WhatsApp Business contacts.1 params
Create a new sales funnel/pipeline for WhatsApp Business contacts.
Parameters* required
namestringFunnel name
manycontacts.funnels.add_stageAdd a stage to a sales funnel/pipeline.3 params
Add a stage to a sales funnel/pipeline.
Parameters* required
namestringStage name
ordernumberStage order position
funnelIdstringFunnel ID
manycontacts.funnels.update_stageUpdate a stage in a sales funnel/pipeline.3 params
Update a stage in a sales funnel/pipeline.
Parameters* required
namestringNew stage name
stageIdstringStage ID to update
funnelIdstringFunnel ID
manycontacts.funnels.contactsList contacts in a funnel/pipeline, optionally filtered by stage.4 params
List contacts in a funnel/pipeline, optionally filtered by stage.
Parameters* required
pagenumberPage number
limitnumberResults per page
funnelIdstringFunnel ID
stage_idstringFilter by stage ID
manycontacts.funnels.deleteDelete a sales funnel/pipeline.1 params
Delete a sales funnel/pipeline.
Parameters* required
idstringFunnel ID to delete
manycontacts.users.listList team members/users in the WhatsApp Business organization.
List team members/users in the WhatsApp Business organization.
No parameter schema in public metadata yet.
manycontacts.users.getGet details of a specific team member/user.1 params
Get details of a specific team member/user.
Parameters* required
idstringUser ID
manycontacts.users.updateUpdate a team member/user profile.2 params
Update a team member/user profile.
Parameters* required
idstringUser ID
namestringUser name
manycontacts.users.inviteInvite a new team member to the WhatsApp Business organization.1 params
Invite a new team member to the WhatsApp Business organization.
Parameters* required
emailstringEmail address to invite
manycontacts.users.deleteRemove a team member from the WhatsApp Business organization.1 params
Remove a team member from the WhatsApp Business organization.
Parameters* required
idstringUser ID to remove
manycontacts.ai_agents.listList AI agents configured to auto-respond to WhatsApp Business messages.
List AI agents configured to auto-respond to WhatsApp Business messages.
No parameter schema in public metadata yet.
manycontacts.ai_agents.getGet details of a specific WhatsApp AI agent including scenarios and configuration.1 params
Get details of a specific WhatsApp AI agent including scenarios and configuration.
Parameters* required
idstringAI Agent ID (UUID)
manycontacts.ai_agents.updateUpdate a WhatsApp AI agent's configuration (instructions, active status, etc.).5 params
Update a WhatsApp AI agent's configuration (instructions, active status, etc.).
Parameters* required
idstringAI Agent ID (UUID)
activebooleanEnable or disable the agent
block_1stringAgent instructions block 1
block_2stringAgent instructions block 2
block_3stringAgent instructions block 3
manycontacts.ai_agents.feedbackGet feedback/conversation logs for a WhatsApp AI agent.1 params
Get feedback/conversation logs for a WhatsApp AI agent.
Parameters* required
idstringAI Agent ID (UUID)
Gavi WhatsApp API
The WhatsApp API built for how developers actually build in 2026. Works in Cursor, Claude Code, Codex, and Lovable.
MCP server · TypeScript SDK · Python SDK · Examples · $9.99/mo
What is this?
A complete WhatsApp Business API platform with:
- MCP Server — Type "send a WhatsApp message" in Cursor or Claude Code and it just works
- REST API — 6 endpoints: send message, send template, send media, broadcasts, webhooks, contacts
- TypeScript SDK —
npm install @gaviwhatsapp/whatsapp - Python SDK —
pip install gaviwhatsapp - Dashboard — Visual form builder, conversation flows, broadcast campaigns, analytics
Quick Start
Option 1: MCP Server (AI coding tools)
Add to .cursor/mcp.json or .claude/mcp.json:
{
"mcpServers": {
"gaviwhatsapp": {
"command": "npx",
"args": ["@gaviwhatsapp/mcp", "--api-key", "gv_YOUR_KEY"]
}
}
}
Then just ask: "Send a WhatsApp message to +919876543210 saying hello"
Option 2: TypeScript SDK
npm install @gaviwhatsapp/whatsapp
import { WhatsApp } from '@gaviwhatsapp/whatsapp'
const wa = new WhatsApp({ apiKey: process.env.GAVIWHATSAPP_API_KEY! })
await wa.send({ to: '+919876543210', text: 'Hello from my app!' })
Option 3: Python SDK
pip install gaviwhatsapp
from gaviwhatsapp import WhatsApp
wa = WhatsApp(api_key="gv_YOUR_KEY")
wa.send(to="+919876543210", text="Hello from my app!")
Option 4: REST API
curl -X POST https://www.gaviventures.com/api/v1/messages \
-H "Authorization: Bearer gv_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"to": "+919876543210", "text": "Hello!"}'
Get an API Key
- Sign up at gaviventures.com
- Connect your WhatsApp Business Account
- Go to Settings > API Keys
Packages
| Package | Description | Install |
|---|---|---|
@gaviwhatsapp/mcp | MCP server for Cursor, Claude Code, Codex | npx @gaviwhatsapp/mcp |
@gaviwhatsapp/whatsapp | TypeScript/Node.js SDK | npm install @gaviwhatsapp/whatsapp |
gaviwhatsapp | Python SDK | pip install gaviwhatsapp |
Examples
| Example | Description | Language |
|---|---|---|
| send-message-ts | Send a text message | TypeScript |
| send-message-python | Send a text message | Python |
| broadcast-campaign | Send personalized broadcast from CSV | TypeScript |
| webhook-receiver | Receive incoming WhatsApp messages | TypeScript |
API Reference
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/v1/messages | Send a text message |
| POST | /api/v1/messages/template | Send a template message |
| POST | /api/v1/messages/media | Send media (image/video/document) |
| POST | /api/v1/broadcasts | Send to multiple recipients |
| POST | /api/v1/webhooks | Register a webhook |
| GET | /api/v1/webhooks | List webhooks |
Full docs: gaviventures.com/docs/api
Pricing
| Plan | Price | Includes |
|---|---|---|
| API | $9.99/mo | API, SDKs, MCP server, webhooks, broadcasts |
| Pro | $24.99/mo | Everything + visual builder, forms, flows, analytics |
7-day free trial. No credit card required. Meta per-message charges billed directly to your WhatsApp Business Account.
Links
License
Source code in this repository is provided for reference and integration purposes. The WhatsApp API service requires a paid subscription. See gaviventures.com for terms.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
YOUR_API_KEY*secretYour API key for the service
Categories
Registryactive
Package@gaviwhatsapp/mcp
TransportSTDIO
AuthRequired
UpdatedApr 23, 2026
