# ChatBot.com MCP for AI Agents MCP > ChatBot.com lets your AI agent take full control of conversational automation and bot workflows. It gives you a single point of access to monitor every user interaction, track complex story paths, and audit bot performance directly from any compatible AI client. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** conversational-ai, bot-workflows, customer-service-automation, chat-automation, interaction-tracking, ai-agents ## Description Stop switching between the chat interface, the analytics dashboard, and the training log just to understand what your customer service bot is doing. This MCP connects ChatBot.com’s full suite of conversational data directly into your agent. You can monitor entire story paths, list every user who has interacted with the bot, or even retrieve specific unrecognized phrases that signal a gap in your knowledge base. It's about getting intelligence on conversation flow—the whole picture—without ever leaving your chat window. If you’re managing multiple systems for bot performance, Vinkius makes it simple: connect once and get access to this full catalog of conversational tools. You can use the agent to look up user profiles or check webhook settings, letting you manage complex automation tasks using natural conversation. ## Tools ### get_story_details Retrieves detailed information about a specific conversational story or workflow path. ### get_chatbot_user_details Pulls and displays detailed profile information for one specific user who interacted with the bot. ### list_chatbot_entities Lists all custom entities that the bot uses to understand and match specific data types, like names or product codes. ### list_story_interactions Generates a full list of every single interaction that took place within a defined story path. ### list_chatbot_stories Provides an overview and list of all active bot workflows or conversational stories configured in the system. ### list_training_data Compiles a report of unrecognized phrases, highlighting areas where the chatbot needs immediate training updates. ### list_chatbot_users Gathers and lists every user who has ever initiated a conversation with your bot. ### list_chatbot_webhooks Reviews all configured webhook integrations, helping you audit how the chatbot sends data to other services. ## Prompt Examples **Prompt:** ``` List all bot workflows we have set up right now. ``` **Response:** ``` **Bot Story Audit Report** Here are the 6 active conversational stories: * `Main Greeting`: The initial customer touchpoint. * `Product FAQ`: Handles billing and feature questions. * `Lead Generation`: Collects contact info for sales follow-up. * `Customer Support Flow`: Escalation path to human agents. * `Billing Inquiry`: Specific flow for invoice issues. * `Account Update`: For changing passwords or addresses. Which story should I dive into? Just name it. ``` **Prompt:** ``` What phrases are users typing that the bot doesn't understand? ``` **Response:** ``` **Training Data Gap Report** We found 18 unrecognized phrases since last week. These require immediate training: * 'How do I cancel my subscription?' (Frequency: 12) * 'Talk to a human agent now.' (Frequency: 8) * 'Is there an alternative product?' (Frequency: 5) Please review these and add them as new intents to the `Product FAQ` story. ``` **Prompt:** ``` Show me all users who opened a chat yesterday. ``` **Response:** ``` **Yesterday's User Activity Log** We found **34 unique users** interacting with the bot yesterday. Key insights: * 12 users came from 'Product FAQ'. * 5 users completed the `Lead Generation` workflow. * The top source of traffic was the main website, generating 7 new interactions. ``` ## Capabilities ### Audit Bot Workflows List all existing bot stories and retrieve detailed information for any specific conversational workflow. ### Track User Activity Pull lists of every user who has interacted with the bot, or get a deep profile on individual users by their unique ID. ### Analyze Conversation Flow Review all recorded interactions within a specific story to follow exactly how a conversation unfolded and where it went wrong. ### Identify Training Gaps Access the list of unrecognized phrases, telling you precisely what users are saying that your bot doesn't understand yet. ### Manage Integrations and Data Review all configured webhook integrations or examine core system metadata like entity definitions to audit how the bot is connected. ## Use Cases ### Diagnosing a Failed Customer Journey A user asks their agent: 'Why did the refund request fail for User 90210?' The agent runs `get_chatbot_user_details` and then uses `list_story_interactions` to show the exact sequence of messages, pinpointing where the bot gave incorrect information. ### Updating Bot Knowledge Base A product manager asks their agent: 'What are we missing in our FAQ flow?' The agent runs `list_training_data` and returns a list of unrecognized phrases, immediately giving the PM actionable items for bot retraining. ### Auditing Bot Connections A development team needs to check all outgoing data points. They ask their agent: 'Show me all webhook connections.' The agent runs `list_chatbot_webhooks` and displays the full list of active external integrations for review. ### Reviewing Bot Scope A CX manager asks their agent: 'What are our current bot flows?' The agent uses `list_chatbot_stories` to present a complete catalog, allowing the manager to see every defined workflow at a glance. ## Benefits - Instead of manually checking dashboards, your agent can list all stories via `list_chatbot_stories` and give you an instant overview of the entire bot's capabilities. - You instantly get context by using `list_story_interactions`, letting your agent trace a user through every single chat message to pinpoint where the confusion happened. - The ability to use `list_training_data` means you don't have to guess what the bot doesn't know; your agent reports the exact phrases that need adding to the training set. - When troubleshooting, running `get_chatbot_user_details` lets you pull a full user profile and conversation history without jumping between multiple internal tabs. - Audit connections easily. Use `list_chatbot_webhooks` or review system metadata with `list_chatbot_entities` to ensure your bot's external data links are correct. ## How It Works The bottom line is that you treat complex back-end data management—like checking user records or training logs—as if it were just another natural conversation prompt for your AI client. 1. Subscribe to this MCP on Vinkius and enter your ChatBot Developer Access Token. 2. Connect your preferred AI client, such as Cursor or Claude, using the token. 3. Ask your agent to perform a task, like 'List all users who chatted with the bot today,' and it executes the necessary data retrieval. ## Frequently Asked Questions **How can I check if my chatbot is losing performance or needs retraining?** You can use ChatBot.com MCP to list unrecognized phrases and get a report on what users are saying that the bot doesn't understand yet. This tells you exactly where your conversational flows need immediate attention. **Can I see every single conversation path for a specific customer?** Yes, by connecting ChatBot.com MCP, you can retrieve all interactions within a story. It gives you the full history—every message exchanged—so you know exactly how and why the user reached their current point. **How do I audit who has used my bot? Does it track every person?** You can list all users who interacted with your bot through ChatBot.com MCP. It provides a complete roster of unique users, helping you measure overall adoption and usage patterns. **Does this help me find out what my bot's current workflows are?** Absolutely. The MCP lets your agent list all active stories (bot workflows). This gives you a full map of every conversation path the chatbot knows how to handle, perfect for scope review. **What if I need to know what external systems my bot talks to?** You can use ChatBot.com MCP to list all configured webhook integrations and audit your system's metadata. This confirms every connection point, ensuring your data routes are secure and correct.