S
socialgroundco/hellohop-mcp
更新 2026-11-04
在 GitHub 查看 ↗直链 · 无中转页
我们没有可直接复制的安装命令,也没有公开的远端端点,所以不出配置。上面那条命令仅供参考,不是我们能担保的可复制命令——编一条出来比不给更糟。 各客户端的接法 →
- ★ 数取值
- 0 ★ · socialgroundco/hellohop-mcp · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
- 评分构成
- 综合分 300 · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
socialgroundco/hellohop-mcp;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# hellohop-mcp
以下摘录自该仓库的 README(片段)
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.
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/socialgroundco-hellohop-mcp/)
- 来源
- awesome · https://github.com/socialgroundco/hellohop-mcp
- 按领域浏览
- MCP 服务
- 收录来源
- 3 个独立来源
- 收录于
- 今天
更多 MCP 服务器
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。