wechatbot-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wechat_loginA | Log into WeChat. If a session is already saved (persisted across restarts), this returns silently. Otherwise it triggers a QR code flow: the PNG is auto-opened on the user's screen and an ASCII copy is saved to ~/.wechatbot/mcp/qr-latest.txt. Returns the account id on success. |
| wechat_logoutA | Stop the bot. With clearCredentials=true, also deletes ~/.wechatbot/credentials so the next login() will require a fresh QR. |
| wechat_statusB | Connection state, account info, receive-queue depth. |
| wechat_send_textA | Send a plain text message to a userId (must be a known user). |
| wechat_send_imageA | Send a local image file. Caption is sent as a separate text message before the image. |
| wechat_send_fileA | Send an arbitrary local file (auto-detected as image / video / file). |
| wechat_send_urlB | Send media from a remote URL. SDK downloads it and uploads to WeChat CDN. |
| wechat_send_typingA | Show "对方正在输入中…" once. Does not auto-stop — pair with wechat_stop_typing. |
| wechat_stop_typingB | Cancel the typing indicator for the given user. |
| wechat_pending_messagesA | Pop and return up to |
| wechat_known_usersA | List user IDs we currently have a context_token for (i.e., who can be messaged back). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Most tools target distinct operations, but send_image and send_file overlap in that both can send local images, differing only in caption handling and auto-detection; send_url vs send_file could also confuse when dealing with remote files. Overall, descriptions clarify most boundaries.
All tools share a consistent wechat_ prefix and snake_case. However, not all follow verb_noun: login/logout/status are bare verbs/nouns, and pending_messages/known_users are adjective-noun phrases, slightly deviating from a strict verb-object pattern though still predictable.
11 tools is well within the 3-15 ideal range. Each tool addresses a distinct need: auth, connection status, sending text/media/URLs/typing indicators, receiving messages, and contact listing. No unnecessary redundancy.
Covers the core lifecycle of a WeChat bot: login/logout, send various content types, receive messages, and list contacts. Minor gaps include lacking user detail lookups, message history search, and group management, but these are not essential for basic bot operation.