# Botsonic MCP for AI Agents MCP

> Botsonic MCP connects your AI agents directly to your custom chatbot platform. Train specialized, accurate chatbots using your own company data—from help articles to pricing pages. Manage bot deployment, track conversations, and analyze lead capture performance without leaving your agent workspace.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** chatbot-training, rag, knowledge-base, ai-support, customer-service, no-code-ai

## Description

This connector lets you manage an entire fleet of highly specific AI bots from a single place. You can train these virtual assistants on vast amounts of proprietary information, like internal wikis or product manuals. Your agents treat the chatbot experience like talking to a dedicated employee who knows everything about your company.

Instead of jumping between your chatbot dashboard, your CRM, and your analytics platform, you keep everything in your AI client. You can ask your agent to check if a bot needs updates, run live conversations for testing, or pull reports on lead quality—all within one conversation thread. This deep integration makes monitoring performance simple. When you connect this MCP via Vinkius, your AI agents get instant access to the full spectrum of chatbot operations, turning complex management tasks into simple commands.

## Tools

### add_knowledge_url
Adds a specified web page URL to a bot's training material so it can answer questions about that content.

### check_botsonic_status
Verifies the connection status between your AI agent and the Botsonic platform.

### create_bot
Builds a new, custom chatbot profile with specific personality instructions.

### get_bot_analytics
Retrieves detailed performance metrics for a bot, such as total messages sent and resolution rate.

### get_bot
Pulls specific details about an existing chatbot, including its current instructions and knowledge base setup.

### get_conversation
Retrieves the full transcript of a single customer chat session for review or debugging.

### list_bots
Shows a comprehensive list of all the chatbot profiles you have set up.

### list_conversations
Provides an overview and listing of multiple past chat sessions that occurred on your bots.

### list_knowledge_base
Lists all the sources (URLs, documents) currently used to train a specific bot's knowledge base.

### list_leads
Gathers and displays a list of all captured lead contacts from customer conversations.

### send_message
Sends a message to a specific bot, receiving an immediate, real-time AI response for testing or querying.

### update_bot
Modifies the instructions or knowledge base of an existing chatbot profile.

## Prompt Examples

**Prompt:** 
```
List all my bots and show the analytics for the one that handles billing questions.
```

**Response:** 
```
Here is a summary of your current bot fleet:

*   **Customer Support Bot (bot_301):** Primary support, 1,284 conversations this month. 
*   **Sales Assistant (bot_302):** Handles pricing and demos, 456 conversations.
*   **Billing Guide Bot (bot_400):** Focused only on invoices/billing questions. **(This is the one you asked about.)**

**📊 Billing Guide Bot Analytics:**
*   Resolution Rate: 91% (Excellent)
*   Average Satisfaction: 4.5/5
*   Total Messages: 3,210
*   Leads Captured: 7
```

**Prompt:** 
```
I just updated our return policy page. Can you add it to the 'Customer Support Bot'?
```

**Response:** 
```
**✅ Updating knowledge base for Customer Support Bot...**

Adding URL: `https://company.com/returns`
*   Status: Crawled successfully.
*   Indexed Sources: 5 pages indexed.
The bot is now training on the new return policy. This content will be available in responses within minutes.
```

**Prompt:** 
```
Show me all leads captured by 'Sales Assistant' last week.
```

**Response:** 
```
**💰 Leads Captured by Sales Assistant (Last 7 Days):**

| Name | Email | Topic of Interest | Messages | Quality Score |
| :--- | :--- | :--- | :--- | :--- |
| Sarah Chen | sarah@techcorp.io | Enterprise Pricing | 4 | High |
| James Miller | james@startupxyz.com | Demo Request | 3 | Medium |
| Lisa Park | lisa@retailco.com | Integration Question | 6 | High |

Please let me know if you want to export these leads or review the full transcript for any of them.
```

## Capabilities

### Manage and Configure Bots
Create new chatbots, update existing ones with different instructions, or retrieve a list of all deployed bots.

### Train Knowledge Bases
Add specific web page URLs to a bot's knowledge base so it answers questions based on your current documentation.

### Monitor and Review Conversations
Browse the full message history for any conversation, or list all conversations that have happened over time.

### Send Test Messages
Send messages to a bot in real time to test its responses before going live with customers.

### Track Captured Leads
Retrieve all lead information that the chatbot collected during customer interactions, making follow-up easy.

### Analyze Performance Data
Get usage metrics like conversation volume, total message count, and resolution rates for any bot.

## Use Cases

### Updating Chatbots After a Product Launch
A product manager adds the new feature guide and pricing pages. They use `add_knowledge_url` to index the documentation, then run test messages using `send_message` to confirm the bot answers questions about the launch correctly.

### Auditing Support Performance
A support manager wants to know which of their 10 bots is failing. They use `list_bots` first, then run `get_bot_analytics` on each one to find the bot with the lowest resolution rate.

### Following Up on Hot Leads
A growth team member needs a list of all contacts who asked about enterprise pricing. They use `list_leads` to pull the data, then review specific transcripts using `get_conversation` for context.

### Debugging Bot Behavior
Before going live, a developer wants to check if a bot knows how to talk about integrations. They use `send_message` repeatedly and inspect the full message history with `list_conversations` until the behavior is perfect.

## Benefits

- Track performance metrics across all bots using `get_bot_analytics` to pinpoint underperforming areas immediately.
- Capture actionable lead data directly via the `list_leads` tool, eliminating manual export steps from chat platforms.
- Quickly test bot responses by sending messages through `send_message`, ensuring accuracy before deployment.
- Maintain a clear record of all customer interactions using `get_conversation` to review specific support tickets later.
- Keep your bots current on new information; you can train them instantly by adding URLs with `add_knowledge_url`.

## How It Works

The bottom line is: you manage and analyze every aspect of your chatbot operation using natural conversation in your favorite AI client.

1. First, connect your Botsonic account to the Vinkius platform using your API token.
2. Then, reference this MCP in your AI client—Claude, Cursor, or any compatible agent—to begin managing your bots.
3. Finally, ask your agent to perform a task, like listing all deployed bots or adding new documentation URLs to a knowledge base.

## Frequently Asked Questions

**How do I make sure my chatbot answers questions using our latest documentation?**
You must use this MCP to train your bot. You add specific URLs from your help center or knowledge base, and the chatbot learns only from that content. This ensures accuracy by keeping its responses grounded in your company's official data.

**Can I see how well my bots are performing right now?**
Yes. You can use this MCP to pull performance analytics, which shows you the total message count, conversation volume, and resolution rate across all your deployed chatbots in one place.

**What if a customer asks about something I haven't documented yet?**
The bot will respond by stating that it doesn't have enough information. This is the expected behavior, and you can use this MCP to review those failed conversations with your support team later.

**Does Botsonic MCP help me collect contact info from chat chats?**
Absolutely. The MCP captures all leads during a conversation. You can run a simple command using the MCP's lead tools to get a list of contacts, including their email and what they were interested in.

**How many different types of bots can I manage with this MCP?**
You can create an unlimited number of specialized chatbots. This MCP lets you manage them all—from a simple FAQ bot to a complex sales assistant—using the same interface.