# Weiban Assistant MCP MCP

> Weiban Assistant MCP handles all customer relationship management for WeCom and WeChat. It lets your agent track leads, manage group chats, retrieve detailed customer profiles, and monitor staff performance across the entire organization.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** lead-management, group-chat-automation, crm-integration, customer-tracking, social-commerce, sales-pipeline

## Description

This connector gives your AI agent a full view of your business interactions inside the WeCom ecosystem. Instead of logging into multiple dashboards to check on leads, chat activity, or customer history, you just ask your agent. It pulls all that information together instantly.

For instance, you can tell it to list all customers who haven't opened an email in 30 days and then get a summary of the group chats they are part of. Your agent handles the entire sequence, bringing data from different parts of WeCom into one conversation thread. Because your credentials pass through Vinkius's secure, zero-trust proxy, you never worry about where those keys sit; they only exist in transit. The real power comes when you chain this MCP with other services—for example, linking it to a billing MCP and then triggering an alert if a high-value customer is flagged as inactive. You build automations that span multiple platforms using one AI agent. It keeps your data accurate and your team responsive without requiring manual effort.

## Tools

### create_lead
Creates a new sales lead record within the WeCom system.

### get_customer_details
Retrieves detailed information for any specific customer account.

### get_group_chat
Gets comprehensive details about a single WeCom group chat.

### get_org_summary
Pulls a high-level overview of organization activity and overall engagement metrics.

### get_staff_stats
Generates performance statistics for staff members, like message handling rates or response times.

### list_chat_records
Lists the history of messages and interactions within a specific chat thread.

### list_customers
Retrieves a full list of all customers associated with your WeCom account.

### list_group_chats
Provides an index of all group chats currently active in the organization.

### list_leads
Generates a comprehensive list of sales leads that need follow-up.

### list_staff
Provides a directory and count of all staff members registered in the organization.

## Prompt Examples

**Prompt:** 
```
List all my WeCom customers from Weiban.
```

**Response:** 
```
I've retrieved your WeCom customers. You have 150 total customers, including 12 high-value accounts marked with specific tags. Would you like to view the details of the most active ones?
```

**Prompt:** 
```
Show me the behavior statistics for staff user 'Mario'.
```

**Response:** 
```
I've listed the performance stats for Mario. Today, he has handled 42 customer messages with an average response time of 2 minutes. His customer satisfaction score is currently 4.9/5.0.
```

**Prompt:** 
```
Check the activity summary for our group chats.
```

**Response:** 
```
I've retrieved the group chat summary. There are 25 active groups with a total of 1,200 participants. The 'VIP Customers' group is currently the most active. Would you like a detailed breakdown of engagement per group?
```

## Capabilities

### Track Customer History
Retrieve specific details on individual customers, list all active users, or get a full summary of organization-wide activity.

### Manage Sales Pipelines
Create new leads and view lists of existing prospects to track the status of potential accounts.

### Monitor Group Chats
List active group chats, retrieve their details, or get a summary of engagement across multiple groups.

### Audit Staff Performance
Get statistics on staff behavior and list all organization employees to monitor team productivity.

## Use Cases

### Identifying Stalled Leads
A sales rep asks: 'Show me all leads created last month that haven't been contacted.' The agent uses `list_leads` and filters them instantly, giving the rep a clear list of who needs follow-up.

### Post-Campaign Analysis
An operations manager asks: 'What was the overall engagement in our main customer group after the product launch?' The agent uses `get_org_summary` and cross-references it with specific chat records using `list_chat_records`.

### Onboarding a New Employee
A team lead asks: 'What is Mario's performance score this quarter?' The agent uses `get_staff_stats` and pulls up his metrics instantly, giving the lead an accurate picture of readiness.

### Auditing Customer Relationships
A customer success team member needs to know a client's full history. They ask the agent to `get_customer_details` for the account and then check their recent chat activity using `list_chat_records`.

## Benefits

- You stop manually checking different chat logs. With the agent, you can run `list_chat_records` to pull chat history and instantly analyze it for key insights.
- Need to qualify a prospect? Instead of opening multiple tabs, ask your agent to use `list_leads` then follow up with `get_customer_details` on the most promising ones.
- Monitor team performance easily. Use `get_staff_stats` to see exactly how many messages staff handled today without running any reports yourself.
- Keep track of who's talking to whom. Your agent can use `list_group_chats` and `get_org_summary` to show you which groups are seeing the most activity right now.
- The process is safer too. Because credentials pass through Vinkius's zero-trust proxy, your keys are never stored on disk; they only move during the call.

## How It Works

The bottom line is, you talk to the MCP through natural conversation; the agent handles the complex data retrieval and orchestration behind the scenes.

1. Subscribe to this MCP on Vinkius. Enter your unique Weiban Corp ID and Secret keys.
2. Connect the MCP to your preferred AI client (like Cursor or Claude). The agent now has access to the communication tools.
3. Tell your agent what you need—for example, 'List my top 10 customers'—and it executes the necessary calls.

## Frequently Asked Questions

**How do I find my Weiban Corp ID and Secret?**
Log in to your Weiban administration backend, go to [App Center] → [Open Platform], and you will find your Corp ID and Secret there. Ensure you have the necessary permissions enabled.

**Can I see chat records through this server?**
Yes. Use the `list_chat_records` tool to retrieve historical chat between staff members and customers. This is essential for auditing service quality and tracking sales conversations.

**Is it possible to monitor group chat activity?**
Yes! You can use the `list_group_chats` tool to see all active groups and `get_group_chat` with a specific ID to retrieve detailed information about participation and engagement levels.

**When I use `get_customer_details`, what specific information can I retrieve for an individual account?**
You get a comprehensive profile, including contact details and their full interaction history within WeCom. This covers everything from initial lead status to current service usage.

**If I use `create_lead`, what input formats or required fields must I provide for the new prospect?**
You need at minimum a contact identifier, assigned owner, and categorization. The MCP validates these inputs instantly to prevent creating incomplete records.

**Does `get_staff_stats` only show message counts, or does it track broader employee performance metrics?**
No, the function tracks behavior beyond just message volume. It provides metrics like average response time and customer satisfaction scores for staff members.

**What kind of overall activity summary do I get when calling `get_org_summary`?**
The organization summary gives a high-level view of engagement across WeCom. It tracks metrics like total active users and departmental participation rates.

**When using `list_customers`, how does the MCP handle retrieving thousands of customer records efficiently?**
It supports paginated calls, meaning you can request data in manageable chunks. This prevents timeouts and ensures quick retrieval even with large datasets.