# ChatFly MCP MCP

> ChatFly connects your AI client to a full suite of chatbot management tools. It lets you build specialized conversational bots that answer product questions, qualify leads, and even book meetings without any human intervention. You train these agents by feeding them external websites or documents, allowing them to act like expert support staff 24/7.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** chatbot-builder, conversational-ai, lead-qualification, knowledge-base, automated-engagement, bot-orchestration

## Description

You're trying to automate customer interactions, but managing the knowledge base is a nightmare. This MCP lets your AI client take over that entire process. Instead of manually copy-pasting website content into training fields, you simply point the bot at URLs or documents using `upload_data_source`. The bot then builds a deep, accurate knowledge graph from that source material. You can manage multiple specialized bots—say one for billing questions and another for product specs—all through one interface. Need to check how well a specific bot is performing? Your agent handles operational monitoring and session history retrieval automatically. This full capability set makes it easy to keep your support agents current, giving you total control over the knowledge base from anywhere within the Vinkius catalog.

## Tools

### chat
Sends a message to an existing chatbot and gets its response.

### create_bot
Creates a new, distinct chatbot instance with a custom welcome message.

### get_bot
Retrieves the specific details and configuration of one existing bot.

### list_bots
Provides a list of all chatbots currently managed by your account.

### list_data_sources
Lists every URL or document source that is contributing knowledge to your bots.

### update_bot
Changes the settings, like welcome messages, for a bot you already built.

### upload_data_source
Adds a new knowledge source (like a website URL) to train one or more bots.

## Prompt Examples

**Prompt:** 
```
List all my available chatbots in ChatFly.
```

**Response:** 
```
I've retrieved your chatbots. You currently have 3 active instances: 'Support Hero' (ID: bot_1), 'Lead Qualifier', and 'Internal FAQ'. Which one would you like to update or train?
```

**Prompt:** 
```
Train 'bot_1' by ingesting 'https://vinkius.com/faq'.
```

**Response:** 
```
Training triggered! I've added the FAQ URL as a data source for 'Support Hero'. ChatFly is now crawling the content to update the knowledge base. I'll monitor the progress for you.
```

**Prompt:** 
```
Ask 'bot_1': 'What are your support hours?'.
```

**Response:** 
```
ChatFly response received: 'Our support team is available Monday to Friday from 9 AM to 6 PM EST.' Shall I check the session history for this query?
```

## Capabilities

### Manage Bot Instances
Create, retrieve details for, and list all specialized chatbot bots.

### Train Bots on External Data
Programmatically ingest data from websites or documents to update a bot's knowledge base.

### Modify Bot Settings
Update existing bots, changing welcome messages or internal metadata without rebuilding them.

### Interact with Bots Live
Send a message to any specific bot and retrieve its immediate AI response for testing or integration.

### Audit Data Sources
List all the URLs and documents currently feeding knowledge into your bots.

## Use Cases

### Handling a product recall announcement
A technical PM needs all bots updated immediately. They instruct their agent to run `upload_data_source` using the official press release URL, ensuring every bot instantly knows the correct procedure for returns and replacements.

### Separating sales from support functions
A founder wants two distinct bots. They use `create_bot` to make 'Sales Bot' and another to make 'Support Bot'. This allows the agent to route lead qualification questions to one, and technical FAQs to the other.

### Monitoring performance after a feature drop
A developer needs to know if the bot is still answering correctly. They use `get_bot` for details and then run `chat` with tricky edge-case questions to confirm accuracy.

### Onboarding new staff into the bot system
A support manager needs to give a bot access to internal HR documents. They use `upload_data_source` and specify the document path, allowing the agent to query internal policies via the chatbot.

## Benefits

- Instantly update bot knowledge bases: If the support team changes a policy, you use `upload_data_source` to feed the new info, so your bots stay current without human intervention.
- Orchestrate multiple agents: Instead of managing one generic chatbot, you can use `list_bots` and `create_bot` to build specialized instances for billing, sales, or support.
- Test interactions on the fly: Use the `chat` tool to send test questions to a bot and see its live response before deploying it to customers.
- Maintain visibility over data: The `list_data_sources` tool lets you audit exactly which documents are feeding knowledge into your system, keeping everything transparent.
- Refine bots without downtime: If the welcome message is wrong or needs tweaking, use `update_bot` to fix it instantly rather than rebuilding the whole bot.

## How It Works

The bottom line is you get a single point of access to manage complex chatbot logic without ever leaving your AI client's environment.

1. First, you connect this MCP to your preferred AI client via Vinkius.
2. Next, use the agent to execute commands like `create_bot` or `list_bots` to build and configure your bot network.
3. Finally, tell the agent to run `upload_data_source` pointing it at a URL, triggering the knowledge ingestion and training process.

## Frequently Asked Questions

**How do I train ChatFly using `upload_data_source`?**
You give the agent a URL or document path. The bot then crawls or ingests that content to build knowledge. You should run this before testing any new information.

**Can I change the welcome message using `update_bot`?**
Yes, you use `update_bot` and provide the new text. This changes the bot's introduction without affecting its knowledge base or overall functionality.

**What if I need to test a bot’s response? Do I use `chat`?**
Yes, running `chat` lets you simulate a live conversation. It sends your prompt and returns the bot's immediate, accurate response for testing.

**How do I see what data my bots are trained on? Do I need `list_data_sources`?**
You use `list_data_sources`. This command gives you a clear directory of every URL and document that is currently feeding knowledge into your entire chatbot fleet.

**How do I use `create_bot` to set up a new chatbot?**
It initializes a brand-new bot instance for you. You must provide both a unique name and an initial welcome message when calling this tool. Remember that creation only sets the shell; you'll need to train it with data sources later.

**If I want details about just one specific chatbot, should I use `get_bot`?**
Yes, using `get_bot` retrieves all metadata for a single specified bot ID. This is helpful when you need to check the current status or configuration of one bot without listing every other instance.

**How do I see an overview of all my available bots at once using `list_bots`?**
It returns a directory containing the ID and name of every chatbot you have built. This is the quickest way to confirm how many bot instances are active in your account.

**Beyond changing the welcome message, what other settings can I adjust using `update_bot`?**
You can modify various parameters of an existing chatbot instance with this tool. This includes adjusting internal metadata or making operational changes without needing to recreate the entire bot.

**How do I find my ChatFly API Key?**
Log in to your account, navigate to **Account Settings** > **API Keys**, and generate a new key for your integration.

**Can I train a bot on a specific URL?**
Yes! Use the `upload_data_source` tool and provide the bot ID along with the website URL you want the bot to learn from.

**How do I test a bot's response via AI?**
Use the `chat` tool to send a message to a specific bot ID. Your agent will return the high-fidelity AI response generated by ChatFly.