# Flow XO MCP

> Flow XO MCP lets your AI agent manage complex, multi-channel chatbots and messaging workflows through natural language commands. Connect it to handle everything from user registration and profile updates to triggering automated sequences across platforms like Slack or Telegram. You get full oversight of all bot flows and end-user activity without logging into multiple dashboards.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** chatbots, webhook-automation, conversational-ai, cross-platform, messaging-workflows

## Description

This MCP connects your chatbot platform directly to any AI agent, letting you manage entire messaging ecosystems using simple conversation prompts. Forget jumping between a chat interface, an analytics dashboard, and a workflow builder. Now, you can talk to your agent and tell it what needs doing: check if a user exists, update their contact info, or even manually send them a follow-up message.

It gives your AI client full visibility into every part of your bot infrastructure. Need to see how often your bots are being used? Get the usage summary instantly. Want to know exactly what happened in a customer's last five conversations? Retrieve that history immediately. If you find this useful, connecting it via Vinkius is straightforward because it lets you access thousands of other tools too.

This means your agent doesn't just *read* data; it acts on it. You can even push data to a webhook URL or toggle an entire automation flow from text, keeping your operations running smoothly and hands-free.

## Tools

### create_user
Registers a completely new user account within the chat system.

### get_user_details
Retrieves and displays detailed profile information for any specific end user.

### get_automation_analytics
Pulls a summary of usage metrics to gauge overall chatbot performance.

### list_broadcasts
Retrieves a list of all mass messages or broadcasts that have been sent out.

### list_bot_accounts
Lists every platform account (like Slack and Messenger) connected to the chatbot system.

### list_chatbot_users
Fetches a complete list of all end users who have interacted with the bot.

### list_user_history
Retrieves the full message conversation history for any selected user.

### list_workflows
Provides an inventory of all available automated chat flows and sequences.

### send_push_message
Sends a direct, immediate message to a user via their unique response path in the chat interface.

### toggle_workflow
Changes the active status of an entire automation flow—turning it on or off instantly.

### trigger_webhook
Starts a predefined automated sequence by sending data to a specific web hook URL.

### update_user
Modifies existing user metadata, such as updating their email or company affiliation.

## Prompt Examples

**Prompt:** 
```
List all my Flow XO chatbot users.
```

**Response:** 
```
Fetching chatbot users... I found your end-user database, including 'John Doe' (Slack) and 'Jane Smith' (Telegram). Would you like to see the interaction history for any of them?
```

**Prompt:** 
```
Disable the workflow 'Old Customer Survey'.
```

**Response:** 
```
Workflow updated! I've successfully disabled the 'Old Customer Survey' flow. It is no longer active in your Flow XO account.
```

**Prompt:** 
```
Send a push message to path 'abc/123': 'Your order has been shipped!'.
```

**Response:** 
```
Message sent! I've delivered your push notification to the specified response path via Flow XO. The user will receive 'Your order has been shipped!' immediately.
```

## Capabilities

### Manage User Data
You can register new users, fetch their profiles for details, update their metadata records, and list all existing end users.

### Monitor Conversation History
Fetch a user's full message history to understand the context of past bot interactions.

### Control Chatbot Flows
List all active automation flows and instantly enable or disable them without touching the platform interface.

### Send Direct Messages
Push immediate messages to users directly through their unique chat response paths.

### Trigger Automated Workflows
Force an automated sequence to run by pushing a data payload to specific webhook URLs.

### View Platform Status
List all connected bot accounts and platforms, or pull high-level usage summaries for performance tracking.

## Use Cases

### A customer asks about their billing history
The agent first calls `list_user_history` to pull the last 20 messages. Then, it uses `get_user_details` to confirm the user's account tier before responding with accurate billing information.

### A marketing campaign needs immediate deployment
The Ops Specialist tells their agent: 'Activate the new Q3 lead nurturing flow.' The agent then uses `toggle_workflow` to switch on the correct sequence, ensuring zero downtime for the campaign.

### A user profile needs an emergency update
The CSM detects a typo in a user's company name. They simply tell their agent to 'Update John Doe's metadata with the new spelling.' The agent calls `update_user` and confirms the change.

### A backend system needs to initiate a flow
When an external payment gateway completes a transaction, it sends a signal. Instead of requiring manual intervention, the specialist uses their agent to call `trigger_webhook`, kicking off the 'Payment Confirmed' bot workflow.

## Benefits

- Stop manually checking user data. With the `get_user_details` and `update_user` tools, you can instantly pull or change a user's profile metadata directly from your agent.
- Never lose track of context again. Use `list_user_history` to retrieve months of chat logs for any user in seconds, giving you immediate insight into past bot engagements.
- Control the entire system without logging in. The `toggle_workflow` and `list_workflows` tools let you enable or disable complex chatbot flows with a simple command.
- Activate marketing campaigns on demand. Instead of navigating to a webhook dashboard, use `trigger_webhook` to push data payloads and start automated sequences remotely.
- Handle immediate customer outreach efficiently. The `send_push_message` tool lets your agent deliver time-sensitive notifications directly into the user's chat path.
- Get high-level performance metrics instantly using `get_automation_analytics`, giving you a usage summary without needing to open analytics reports.

## How It Works

The bottom line is, you're using a single conversation window to run complex administrative tasks usually requiring multiple logins.

1. Subscribe to this MCP through the Vinkius Marketplace.
2. Provide your Flow XO API Key in the connection settings.
3. Use natural language prompts inside any compatible AI client to manage users and trigger workflows.

## Frequently Asked Questions

**How do I list all my chatbot users using Flow XO MCP?**
Use the `list_chatbot_users` tool to fetch a comprehensive list of every end-user who has interacted with your bot. This gives you an immediate inventory of your audience.

**Can I update user data through Flow XO MCP?**
Yes, the `update_user` tool lets you modify existing user metadata, such as changing their email address or updating their status without needing access to a CRM system.

**What is the best way to test an automation flow with Flow XO MCP?**
You use the `trigger_webhook` tool. Instead of manually running the workflow, you pass data through this function call to simulate a live external trigger and test its responsiveness.

**Does Flow XO MCP help me see past customer interactions?**
Absolutely. The `list_user_history` tool allows your agent to retrieve the complete message history for any specific user, giving you full context on their journey with your bot.

**How do I turn off a chatbot flow quickly using Flow XO MCP?**
You use the `toggle_workflow` tool. You simply tell your agent which flow to disable, and it immediately sets the status to inactive, taking the bot offline safely.