# BotGenuity MCP MCP > BotGenuity MCP lets you connect your AI agent directly to a powerful chatbot platform. You can list all your bots, retrieve full conversation histories, and capture lead metadata—all from one place. Stop jumping between portals; manage every interaction through natural conversation with your preferred client. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** chatbot-builder, conversational-ai, digital-assistant, customer-engagement, automated-support, lead-capture ## Description You run customer-facing bots, but managing them shouldn't feel like juggling five different dashboards. This MCP gives your AI agent a direct pipeline into BotGenuity, giving you full control over your automated chat operations and the data they collect. You can programmatically list all your active chatbots to check configurations or instantly send messages to test performance in custom workflows. Need to see what happened yesterday? Use the tools to retrieve detailed chat histories for any customer thread. It also pulls in complete directories of captured leads, giving you contact metadata and context from every interaction. Whether you’re monitoring a bot's health or pulling lead data into your CRM, this MCP makes it all available through your agent, which is hosted on Vinkius, so you don't have to leave your workspace. ## Tools ### get_chatbot_details Retrieve specific configuration data for one particular chatbot instance. ### get_conversation_history Fetch the complete, detailed log of messages from a past customer chat session. ### list_chatbots Get an inventory listing of every chatbot available in your BotGenuity account. ### list_chatbot_conversations See a list of recent conversation sessions for a specific bot. ### list_captured_leads List all contact leads that were captured by any chatbot over time. ### chat_with_bot Send a message to an active bot and get its immediate text response. ## Prompt Examples **Prompt:** ``` List all my chatbots in BotGenuity. ``` **Response:** ``` I've retrieved your chatbots. You currently have 3 active bots, including 'Customer Hero' (ID: B123) and 'Sales Assistant'. Which one should we check for lead activity? ``` **Prompt:** ``` Show the captured leads for chatbot ID 'B123'. ``` **Response:** ``` Fetching leads... Chatbot B123 has captured 12 new leads today, including @user1 and @user2. I've retrieved their contact metadata and high-fidelity interest tags for you. ``` **Prompt:** ``` Ask my 'Customer Hero' bot: 'What are our shipping rates?'. ``` **Response:** ``` Bot response received: 'Our standard shipping is $5.99, or free for orders over $50.' Shall I check the session logs for this interaction? ``` ## Capabilities ### List and track bots You can list every chatbot instance in your account and get its current operational status. ### Retrieve conversation logs This lets you pull the entire history of any chat, giving a perfect overview of what a customer discussed with the bot. ### Get lead records You access all leads captured during chatbot interactions, including contact details and specific points of interest. ### Initiate chat messages The agent can send a message to any connected chatbot, useful for testing or triggering workflows. ### Monitor bot status You pull configuration details and account connectivity reports directly through the MCP. ## Use Cases ### Auditing a difficult customer interaction A support agent needs to understand why a customer got frustrated last week. They ask their agent to use `list_chatbot_conversations` first, then specify the ID they care about. Finally, they call `get_conversation_history` to get the full text log and diagnose the issue. ### Running a lead generation report A marketing manager needs to know how many new leads came in this month. They ask their agent to use `list_captured_leads`, which returns all contacts along with high-fidelity interest tags, ready for immediate CRM import. ### Checking bot uptime after a deployment A product team member needs to verify that the new 'Billing Bot' is working correctly. They ask their agent to run `get_chatbot_details` for the specific bot, confirming its current configuration and operational status. ### Simulating a sales chat flow A trainer wants to test a new script. Instead of logging into the platform, they ask their agent to use `chat_with_bot` with a specific prompt, getting an immediate bot response for training purposes. ## Benefits - Audit performance instantly. You can use `get_conversation_history` to review any chat thread, giving your team full context without manually digging through logs. - Improve lead quality tracking. Use `list_captured_leads` to pull a consolidated list of contacts and their associated interest tags from the chatbot platform. - Get an inventory snapshot. Instead of guessing which bots exist, use `list_chatbots` to get a full directory of every bot you manage in your account. - Test workflows on demand. You can call `chat_with_bot` to programmatically send test messages and see how the chatbot responds before deploying changes. - Centralize monitoring. Use `get_chatbot_details` to check specific bot configurations or connectivity statuses, eliminating the need to jump into separate management portals. ## How It Works The bottom line is that you use your agent as a dedicated bot engineer; it handles all the API calls for you. 1. Subscribe to this MCP on Vinkius. 2. Retrieve your API Key (Bearer Token) from your BotGenuity dashboard settings. 3. Use your AI client to call the tools, accessing all bot management and lead data in a single conversation. ## Frequently Asked Questions **How do I list all my bots using the `list_chatbots` tool?** Just ask your agent to run the `list_chatbots` tool. It will return a complete inventory of every bot in your account, giving you their IDs and names. **What does `get_conversation_history` need as input?** `get_conversation_history` requires an identifier for the specific chat session. You'll usually get this ID after using `list_chatbot_conversations` first. **Can I use `list_captured_leads` to filter by date?** The tool fetches all leads captured, but you can refine the results in your prompt. The MCP handles listing the data so you can then apply any necessary filtering logic. **How do I test a bot's response using `chat_with_bot`?** Simply tell your agent to run `chat_with_bot`, providing the target chatbot ID and the message you want it to send. It returns the bot's immediate reply. **What information do I need to access the API when using `get_chatbot_details`?** You must provide a valid bot ID. If the ID you give doesn't exist, the system returns an explicit error code and message specifying that the chatbot could not be found. **Does `list_chatbot_conversations` include customer metadata for each chat?** Yes, it retrieves detailed conversation records. This includes high-fidelity contact information and associated user IDs for every message thread listed. **What happens if I send too many requests using `chat_with_bot` in a short period?** The platform enforces standard rate limits to ensure stability. If you exceed the allowable volume, your agent will receive an appropriate HTTP 429 error, and you'll need to wait for the retry window. **Can I use `list_captured_leads` to see which chatbot generated the lead?** Absolutely. When listing captured leads, the output includes a specific field identifying the source bot ID. This lets you track exactly which conversational AI instance brought in the contact. **How do I find my BotGenuity API Key?** Log in to your account, select a chatbot, navigate to **Settings** > **Security**, and generate your API Bearer Token. **Can I test bot responses via AI?** Yes! The `chat_with_bot` tool allows you to interact with your chatbots and retrieve high-fidelity AI responses programmatically. **How do I retrieve captured leads?** Use the `list_captured_leads` tool with a specific chatbot ID to retrieve all contact information collected during user sessions.