# ManyChat MCP

> ManyChat MCP automates messenger marketing directly from your AI agent. It lets you manage subscriber profiles, apply tags for segmentation, and trigger entire conversation flows without leaving your client environment. Find users by name or custom fields, update their status, and control every touchpoint in your chat automation.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** messenger-marketing, chatbot, subscriber-segmentation, flow-automation, lead-nurturing, omnichannel-messaging

## Description

Managing a large list of contacts across different messaging channels usually means switching between five tabs and copying data back and forth. This MCP changes that. Connect it to any AI agent, and you gain full command over your messenger marketing flows through natural conversation.

You can instantly find specific subscribers—whether by their name or a custom field value. Once located, your agent handles the rest. You can read all their existing tags, add new ones (like 'High Value Lead'), remove old ones, and even set up custom fields if needed. Need to send them a welcome sequence? You just tell your agent which flow to use; it sends the message immediately.

This level of control means you don't have to leave your workspace. Instead, you manage subscriber data, tags, and flows right from where you are working, making complex segmentation tasks simple conversational commands. Because this MCP is part of Vinkius, you get access to a massive catalog of tools, ensuring that if the automation task exists, your agent can find it.

## Tools

### add_tag
Applies a specific label to an existing subscriber profile.

### find_subscriber_by_custom_field
Searches for subscribers whose profiles match a specified custom field value.

### find_subscriber_by_name
Retrieves the profile of a subscriber by knowing their full name.

### get_subscriber_flows
Lists all automated conversation flows that are assigned to a particular user.

### get_subscriber_info
Retrieves the core data and status details for any subscriber using their unique ID.

### get_subscriber_tags
Pulls a list of all tags currently assigned to a specific user's account.

### list_custom_fields
Shows every custom data field that can be added or queried on your messaging page.

### list_tags
Provides a complete list of all tags currently in use across the entire account.

### remove_tag
Removes an existing label from a subscriber's profile when they change status or segment.

### send_flow
Immediately initiates and sends a specific, pre-written conversation flow to the target user.

### set_custom_field
Updates or creates a custom data field value for a subscriber's record.

## Prompt Examples

**Prompt:** 
```
Find subscriber info for ID 12345678.
```

**Response:** 
```
I've retrieved the info for subscriber 12345678. Name: John Doe, Gender: male, Status: active.
```

**Prompt:** 
```
Add the 'VIP' tag to subscriber 12345678.
```

**Response:** 
```
The 'VIP' tag (ID: 987) has been successfully added to subscriber 12345678.
```

**Prompt:** 
```
List all tags on my ManyChat page.
```

**Response:** 
```
Here are the tags for your page: 'VIP', 'New Lead', 'Follow-up'.
```

## Capabilities

### Discovering Users
Locate specific subscribers by searching their name or querying unique values from custom fields.

### Segmenting Audiences
Add, remove, or check all existing tags on a subscriber to accurately group them for targeted campaigns.

### Updating Profiles
Set specific values in custom fields on a user's profile after gathering new data points.

### Controlling Conversational Flows
Send pre-built automated conversation flows to single subscribers or list which sequences are available.

### Retrieving User Data
Fetch detailed information, all associated tags, and existing flow assignments for any given subscriber ID.

## Use Cases

### A lead needs follow-up after an event.
The sales team knows a specific contact attended the October webinar. Instead of finding them manually, they prompt their agent: 'Find users who have the custom field 'Webinar Attended' set to TRUE.' The agent uses `find_subscriber_by_custom_field` and then runs `add_tag` on all results, followed by sending a specific follow-up flow.

### A user profile needs immediate correction.
Customer support gets a call from 'John Smith' who was miscategorized. The agent uses `find_subscriber_by_name` to locate the ID, then executes `set_custom_field` to fix their status and runs `remove_tag` for the old incorrect tag.

### Running a complex qualification sequence.
A user interacts with a bot. The agent first checks if the user exists using `get_subscriber_info`. If they do, it executes `add_tag` and then runs `send_flow` to kick off the next stage of their nurturing journey.

### Need a list of all current campaign groups.
The marketing manager needs to audit what tags are available. They simply ask the agent to 'List all usable tags.' The tool responds by running `list_tags`, giving them the full inventory at once.

## Benefits

- Instead of manually searching for users in the ManyChat dashboard, you simply ask your agent to `find_subscriber_by_name` or by a custom field value. The data comes back instantly for immediate action.
- Segmenting becomes trivial. You can tell your agent to `add_tag` (e.g., 'Webinar Attendee') or `remove_tag` based on conversation history, keeping your campaigns highly accurate.
- When a lead qualifies, you don't copy/paste details. Your agent can execute the sequence: `set_custom_field` first, then run `add_tag`, and finally send the appropriate welcome flow using `send_flow`.
- Never wonder what a user is connected to again. Use `get_subscriber_tags` or `get_subscriber_flows` to pull all necessary context into your conversation history in seconds.
- The MCP lets you run complex logic—like checking if a user exists (`get_subscriber_info`) before trying to update them, eliminating manual double-checks and API errors.

## How It Works

The bottom line is that you control complex marketing automation steps entirely through conversation, without ever needing to manually navigate the ManyChat dashboard.

1. First, subscribe to the ManyChat MCP on Vinkius and provide your API Token.
2. Next, your AI client calls a specific tool function (like finding users or adding tags) using natural language prompts.
3. The MCP executes the command against your ManyChat account and sends the resulting data back to your agent for immediate use.

## Frequently Asked Questions

**How do I find a user using ManyChat with this MCP?**
You can use `find_subscriber_by_name` if you know the person's name, or `find_subscriber_by_custom_field` if they have specific data like an account ID.

**Can ManyChat MCP update a user's status?**
Yes. You can use `set_custom_field` to change custom field values, which often dictates the user's active status or qualification level.

**Is sending a flow permanent after I run it?**
The MCP allows you to initiate the message using `send_flow`. The conversation history and the assigned flows are always visible via tools like `get_subscriber_flows` for auditing.

**What is the difference between getting info and listing tags?**
`get_subscriber_info` pulls all core data (name, status, etc.) by ID. Meanwhile, `get_subscriber_tags` only gives you a list of every tag attached to that user.

**Does ManyChat MCP handle bulk tagging?**
Yes, if your agent can retrieve multiple subscriber IDs (for example, by listing tags first), it can then execute `add_tag` on those groups of users sequentially.