Skip to content
MCP server

Whatsmcp

Hosted MCP server giving AI agents a WhatsApp number, personal or official Business

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
0.1.195
Listing updated
2 days ago

About Whatsmcp

Whatsmcp is a freemium MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

WhatsMCP exposes a real WhatsApp number to an agent over one hosted endpoint with OAuth sign-in or a bearer API key, so there is no server to run. A Personal number is linked as a device by scanning a QR code, much like WhatsApp Web. A Business (official) number connects through Facebook login to Meta's Cloud API, and it follows Meta's rules on templates and the 24-hour reply window.

The site lists 46 tools, but which appear in tools/list depends on the plan; a tool a plan does not include is absent rather than refusing. They cover messaging and media, message operations such as react, edit and revoke on Personal numbers, contacts, blocklists, groups and channels, call history, AI voice agents that place WhatsApp calls, templates and webhooks. New messages can be fetched with an opaque cursor, or pushed to your backend by webhook.

For Personal numbers you choose the network exit with a SOCKS5 proxy or WireGuard peer. The site says this controls where traffic goes and does not prevent WhatsApp from acting on an account. Pricing is flat per connected number, with Meta's own fees billed to Business numbers directly.

Install

Run in a terminal

claude mcp add --transport http whatsmcp https://api.whatsmcp.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.whatsmcp.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "whatsmcp": {
      "url": "https://api.whatsmcp.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "whatsmcp": {
      "type": "http",
      "url": "https://api.whatsmcp.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "whatsmcp": {
      "serverUrl": "https://api.whatsmcp.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "whatsmcp": {
      "type": "http",
      "url": "https://api.whatsmcp.com/mcp"
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

wa_pair_account
Start a pairing run and return a QR code for a Personal number
wa_send_message
Send a message or start a Business conversation with a template

What it does

Personal and Business numbers
Link a number by QR code or connect an official Cloud API number through Facebook.
Messaging toolkit
Send text, images, documents and voice notes, page history and download attachments.
Groups and channels
Create groups, join by invite link, follow channels and administer members and settings.
AI voice calls
Have an AI voice agent place a WhatsApp call and follow it while it runs.
Cursor polling and webhooks
Fetch messages without gaps or duplicates, or push inbound events to your backend.
Per-number egress
Route a Personal number's traffic through your own SOCKS5 proxy or WireGuard peer.
Console
Pair numbers, track plan caps, mint API keys and inspect webhook attempts.

Good for

  • Let an assistant send and read WhatsApp messages
  • Start Business conversations with pre-approved templates
  • Run an AI agent that answers WhatsApp chats from your own knowledge base
  • Log WhatsApp threads into a CRM
  • Place AI-assisted WhatsApp calls

Pricing

Freemium

Free plan; paid plans per number (Starter, Pro, Max, Business tiers); prices not shown

Prices change. Check whatsmcp.com before you buy.

Whatsmcp FAQ

How do I connect it?

Add https://api.whatsmcp.com/mcp to your client and sign in with OAuth, or send a bearer API key.

Is there a free plan?

Yes. The Free plan allows 30 messages a day and 100 MCP calls a day for one Personal number, and Business numbers can be tried free for 7 days.

Does it charge per message?

The pricing page says plans are flat per number with no per-message markup. Business numbers also pay Meta's own fees.

Does it stop WhatsApp from blocking an account?

No. The site says egress control only decides where traffic leaves and does not change how WhatsApp treats the account.

Is Whatsmcp free?

Whatsmcp has a free plan, with paid plans for more usage or features.

How do I add Whatsmcp to Claude Code?

Run this command in your terminal: claude mcp add --transport http whatsmcp https://api.whatsmcp.com/mcp

What are the best alternatives to Whatsmcp?

The closest alternatives to Whatsmcp are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Whatsmcp

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity