# WeChat Official Accounts MCP

> WeChat Official Accounts / 微信公众号 connects your AI agent directly to WeChat’s backend systems. Manage subscriber lists, send broadcast messages, and control account menus—all through natural conversation. This MCP lets you pull detailed user profiles, publish custom navigation buttons, and run structured marketing blasts without logging into the complex WeChat portal.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** social-ecosystem, subscriber-management, broadcast-messaging, customer-engagement, menu-orchestration

## Description

This connector gives your AI agent control over WeChat Official Accounts (微信公众号), making it the central hub for managing social engagement in China. Forget navigating the complicated WeChat MP portals; you just talk to your agent. Your agent handles everything from checking account status and pulling user profiles to publishing custom menus or sending out structured alerts. You can instantly retrieve subscriber lists, send personalized messages, or audit all permanent media assets without ever leaving your AI workspace. When running large-scale customer support or coordinating a content blast, the agent acts as your dedicated social operations assistant, giving you accurate data and reliable actions from one place. If you use Vinkius for other services, adding WeChat makes it the single source of truth for managing China's dominant messaging platform.

## Tools

### create_custom_menu
Creates a brand new custom navigation menu for the official account interface.

### delete_custom_menu
Removes an existing custom navigation menu from the account profile.

### get_account_status
Checks and reports on the current connectivity status of the WeChat official account.

### get_custom_menu
Retrieves the full configuration details of the custom menu currently attached to the account.

### get_material_count
Counts and reports the total number of permanent media assets available in the library.

### get_user_info
Fetches detailed profile information for a specific subscriber using their unique OpenID identifier.

### list_articles
Lists the titles and details of permanent news articles published in the account's material library.

### list_users
Retrieves a list of all subscribers currently linked to the official account.

### send_custom_text
Sends an unstructured, personalized text message directly to one or more specified users.

### send_template_message
Dispatches a structured notification using a pre-approved template ID to subscribers.

## Prompt Examples

**Prompt:** 
```
Get the profile for user with OpenID 'o88210934...'.
```

**Response:** 
```
I've retrieved the user profile. The user is nicknamed 'Zhang San', based in Shanghai, China. They are a male subscriber. Would you like to send them a direct message or check their interaction history?
```

**Prompt:** 
```
Show me the current custom menu for our account.
```

**Response:** 
```
I've retrieved your current menu configuration. You have 3 main buttons: 'Products', 'Support', and 'About Us'. Each button leads to specific sub-menus or external links. Would you like to modify any of these entries?
```

**Prompt:** 
```
Send a template message to 'o992018...' using template ID 'TEMP_8821'.
```

**Response:** 
```
I've sent the template message to the specified user. The transaction ID is `88210934`. The user will receive the structured notification on their WeChat app immediately. Should I check the delivery status?
```

## Capabilities

### Manage account menus
Create, read, or delete custom navigation buttons that appear on your official account profile.

### Retrieve user details
Get specific subscriber profiles and detailed information using the subscriber's OpenID.

### Send targeted messages
Dispatch both freeform custom text alerts and structured template notifications to individual users or groups.

### List subscribers
Pull a list of all current subscribers associated with the account.

### Audit content assets
Browse and count available permanent media items or news articles stored in your material library.

## Use Cases

### The Quarterly Product Launch
A marketing manager needs to notify 50,000 subscribers about a new product feature. Instead of manually drafting and queuing messages, they prompt the agent: 'Send template message using ID TEMP_LAUNCH.' The agent handles the broadcast via `send_template_message` to ensure perfect delivery for everyone.

### Handling Support Backlogs
The support lead needs to check if a user, who complained yesterday, has been reached. They ask the agent to run `get_user_info` first, then instruct it to use `send_custom_text`, ensuring the follow-up message is direct and personalized.

### Updating Account Branding
The design team changes its branding. Instead of logging into the portal to modify navigation, they tell their agent: 'Create a new custom menu with links for Careers and Contact.' The MCP executes `create_custom_menu` instantly.

### Content Strategy Planning
The editor wants to know if enough articles exist for the next month's campaign. They ask the agent to run `list_articles` and check `get_material_count`, getting an immediate audit of available content without leaving their workspace.

## Benefits

- Avoid manual menu changes. You can use the `create_custom_menu` tool to instantly build and deploy new navigation structures, all through a simple conversation with your agent.
- Get real customer insight. Instead of guessing who needs help, ask for user data and let the MCP run `get_user_info` to verify subscriber identity immediately.
- Run large campaigns without copy/paste errors. The ability to use `send_template_message` ensures structured alerts—like payment reminders or status updates—reach users perfectly every time.
- Manage content volume easily. You don't have to manually check the portal; just ask for a material count, and the MCP runs `get_material_count`, telling you exactly how much content is ready.
- Streamline support workflows. The agent can run `list_users` first, then use `send_custom_text` to follow up with specific individuals who haven't responded.

## How It Works

The bottom line is, you get real-time social platform operations access without needing any specialized developer tools or logins.

1. Subscribe to this MCP, providing the necessary WeChat AppID and AppSecret.
2. Your AI client authenticates using these credentials, establishing a live connection to the WeChat system.
3. You ask your agent to perform an action, like 'list all subscribers' or 'send a template message.' The agent executes the command via the MCP and reports the result.

## Frequently Asked Questions

**How do I check if my WeChat Official Accounts / 微信公众号 connection is working?**
Use the `get_account_status` tool. This immediately verifies connectivity and lets you know if there are any system issues before you try to send messages or manage menus.

**Can I update my main menu buttons using WeChat Official Accounts / 微信公众号 MCP?**
Yes, you can use `create_custom_menu` for new additions and `get_custom_menu` to review the current setup. You'll also need `delete_custom_menu` if you're retiring an old button.

**What is the difference between sending a text message and a template message with WeChat Official Accounts / 微信公众号?**
A custom text message (`send_custom_text`) is freeform, letting you write anything. A template message uses a structured format (`send_template_message`), which ensures the notification looks professional and gets delivered reliably.

**Does this MCP let me list all my subscribers for marketing?**
Absolutely. You can use `list_users` to get a full roster of your subscriber IDs, or if you need deeper context, run `get_user_info` on individual users.

**How many types of content can I audit with WeChat Official Accounts / 微信公众号 MCP?**
You can check two things: the total count of permanent media assets using `get_material_count`, and you can view a list of published news articles via `list_articles`.