S
socialgroundco/hellohop-mcp
updated 2026-11-04
View on GitHub ↗Direct link · no redirect page
We have no copy-paste install command and no public remote endpoint, so we do not print a config. The step above is reference only, not a command we can vouch for. A made-up one is worse than none. How each client wires MCP up →
- Star count
- 0 ★ · socialgroundco/hellohop-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
socialgroundco/hellohop-mcp;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# hellohop-mcp
Excerpted from the repository README (abridged)
HelloHop is an independent WhatsApp API for developers: send and receive messages, automate groups and communities, and get signed webhooks, from $25 USD per number per month with a free sandbox.
This is the HelloHop MCP server. It lets an MCP client (for example Claude Desktop, Claude Code or Cursor) work with one channel of the public API: read the channel's status, the chats it has observed, recent messages, its groups and communities, and a contact. Sending (a text, media by URL, a poll, a reaction) is off by default and available only when you turn it on. Docs: https://hellohop.app/docs/mcp. HelloHop is not affiliated with or endorsed by WhatsApp or Meta.
## Install
Requires Node.js 22 or later. Run it with npx, no separate install step:
sh
npx -y hellohop-mcp
Your MCP client starts the server for you once it is configured (see Claude Desktop and Claude Code below). The server reads its settings from the environment variables listed under Environment.
## Tools
| Tool | Request | Notes |
| channel_status | GET {base}/sessions/{channel} | include_safety: true also reads GET {base}/sessions/{channel}/safety. |
| list_chats | GET {base}/sessions/{channel}/chats | Up to 100 chats from the channel's own log. |
| read_messages | GET {base}/sessions/{channel}/chats/{chat}/messages | Up to limit messages (default 50, at most 500); next_before goes back as before. chat is sent as written, for example 15551234567@s.whatsapp.net. |
| list_groups | GET {base}/sessions/{channel}/groups | Asks WhatsApp; do not poll (a throttled number answers 429 whatsapp_rate_limited). |
| get_group | GET {base}/sessions/{channel}/groups/{group} | Asks WhatsApp. |
| get_community | GET {base}/sessions/{channel}/communities/{community} | Asks WhatsApp. |
| list_community_subgroups | GET {base}/sessions/{channel}/communities/{community}/subgroups | Asks WhatsApp. |
| get_contact | GET {base}/sessions/{channel}/contacts/{who} | The channel's stored contact entry; does not ask WhatsApp. |
| send_text | POST {base}/sessions/{channel}/messages/text | Only when GATEWAY_ALLOW_SEND=1. Body {to, text}, plus quoted if given. |
| send_media | POST {base}/sessions/{channel}/messages/{kind} | Only when GATEWAY_ALLOW_SEND=1. kind is image, video, audio, voice or document; body {to, url} plus caption, filename, mime_type if given. The gateway fetches the URL. |
| send_poll | POST {base}/sessions/{channel}/messages/poll | Only when GATEWAY_ALLOW_SEND=1. Body {to, question, options} (2 to 12), plus multiple if given. |
| react | PUT {base}/sessions/{channel}/messages/{message_id}/reaction | Only when GATEWAY_ALLOW_SEND=1. Body {emoji}. |
| unreact | DELETE {base}/sessions/{channel}/messages/{message_id}/reaction | Only when GATEWAY_ALLOW_SEND=1. No body. |
| delete_message | DELETE {base}/sessions/{channel}/messages/{message_id} | Only when GATEWAY_ALLOW_SEND=1. No body. Deletes for everyone a message this number sent, within 48 hours. |
check_numbers (always registered; it sends no message) starts a number check from 1 to 50 numbers (POST {base}/sessions/{channel}/number-checks, plus refresh if given), or reads one by job_id (GET the check, then a page of its rows with offset, limit and status). The check runs in the background on the channel's own connected non-sandbox number, spaced out, with a daily check allowance by number age, so a long list takes hours or days and it cannot be made faster. The number checker is included with every paid number. The account needs at least one active non-sandbox channel, including one covered by a paid, complimentary, promotional or admin grant. Otherwise the service returns 403 number_checker_requires_paid_number; a sandbox request from an eligible account returns 403 number_checker_requires_non_sandbox_channel. A paused check says why and resumes by itself (only channel_down waits for you; account_suspended must be resolved); a failed check reports its code and reason in failure (check_failed for an upstream failure). Read its reason before retrying. Rows carry phone_e164, country, jid, lid, is_business (present only when true), verified_name, checked_at, and cached with age_seconds. A check is a point-in-time answer and can be wrong or out of date; it does not promise delivery.
This is the HelloHop MCP server. It lets an MCP client (for example Claude Desktop, Claude Code or Cursor) work with one channel of the public API: read the channel's status, the chats it has observed, recent messages, its groups and communities, and a contact. Sending (a text, media by URL, a poll, a reaction) is off by default and available only when you turn it on. Docs: https://hellohop.app/docs/mcp. HelloHop is not affiliated with or endorsed by WhatsApp or Meta.
## Install
Requires Node.js 22 or later. Run it with npx, no separate install step:
sh
npx -y hellohop-mcp
Your MCP client starts the server for you once it is configured (see Claude Desktop and Claude Code below). The server reads its settings from the environment variables listed under Environment.
## Tools
| Tool | Request | Notes |
| channel_status | GET {base}/sessions/{channel} | include_safety: true also reads GET {base}/sessions/{channel}/safety. |
| list_chats | GET {base}/sessions/{channel}/chats | Up to 100 chats from the channel's own log. |
| read_messages | GET {base}/sessions/{channel}/chats/{chat}/messages | Up to limit messages (default 50, at most 500); next_before goes back as before. chat is sent as written, for example 15551234567@s.whatsapp.net. |
| list_groups | GET {base}/sessions/{channel}/groups | Asks WhatsApp; do not poll (a throttled number answers 429 whatsapp_rate_limited). |
| get_group | GET {base}/sessions/{channel}/groups/{group} | Asks WhatsApp. |
| get_community | GET {base}/sessions/{channel}/communities/{community} | Asks WhatsApp. |
| list_community_subgroups | GET {base}/sessions/{channel}/communities/{community}/subgroups | Asks WhatsApp. |
| get_contact | GET {base}/sessions/{channel}/contacts/{who} | The channel's stored contact entry; does not ask WhatsApp. |
| send_text | POST {base}/sessions/{channel}/messages/text | Only when GATEWAY_ALLOW_SEND=1. Body {to, text}, plus quoted if given. |
| send_media | POST {base}/sessions/{channel}/messages/{kind} | Only when GATEWAY_ALLOW_SEND=1. kind is image, video, audio, voice or document; body {to, url} plus caption, filename, mime_type if given. The gateway fetches the URL. |
| send_poll | POST {base}/sessions/{channel}/messages/poll | Only when GATEWAY_ALLOW_SEND=1. Body {to, question, options} (2 to 12), plus multiple if given. |
| react | PUT {base}/sessions/{channel}/messages/{message_id}/reaction | Only when GATEWAY_ALLOW_SEND=1. Body {emoji}. |
| unreact | DELETE {base}/sessions/{channel}/messages/{message_id}/reaction | Only when GATEWAY_ALLOW_SEND=1. No body. |
| delete_message | DELETE {base}/sessions/{channel}/messages/{message_id} | Only when GATEWAY_ALLOW_SEND=1. No body. Deletes for everyone a message this number sent, within 48 hours. |
check_numbers (always registered; it sends no message) starts a number check from 1 to 50 numbers (POST {base}/sessions/{channel}/number-checks, plus refresh if given), or reads one by job_id (GET the check, then a page of its rows with offset, limit and status). The check runs in the background on the channel's own connected non-sandbox number, spaced out, with a daily check allowance by number age, so a long list takes hours or days and it cannot be made faster. The number checker is included with every paid number. The account needs at least one active non-sandbox channel, including one covered by a paid, complimentary, promotional or admin grant. Otherwise the service returns 403 number_checker_requires_paid_number; a sandbox request from an eligible account returns 403 number_checker_requires_non_sandbox_channel. A paused check says why and resumes by itself (only channel_down waits for you; account_suspended must be resolved); a failed check reports its code and reason in failure (check_failed for an upstream failure). Read its reason before retrying. Rows carry phone_e164, country, jid, lid, is_business (present only when true), verified_name, checked_at, and cached with age_seconds. A check is a point-in-time answer and can be wrong or out of date; it does not promise delivery.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/socialgroundco-hellohop-mcp/)
- Source
- awesome · https://github.com/socialgroundco/hellohop-mcp
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.