# The Botforge MCP for AI Agents AI Agent Connect

> The Botforge MCP lets you manage your conversational AI bots directly from your AI client. You can check bot statuses, submit test data to contact forms, and monitor real-time events from your bot engine without switching tabs. It's designed to bridge the gap between your bot management platform and your daily workflow.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DkHdQdnuDxv28J5P43i8QyRerYMPvO6YVOR2KiBy/ai-agent-connect
- **Tags:** chatbot-platform, conversational-ai, lead-generation, webhook-integration, bot-monitoring, thebotforge

## Description

The Botforge MCP lets you manage your conversational AI bots directly from your AI client. Instead of jumping between different dashboards to check if your bots are online or to see what data a form requires, you can just ask your agent to do it for you. You can pull samples of form fields to see exactly what your bot expects, or submit test leads to make sure your automation is actually working. If you need to stay updated on how people are interacting with your bots, you can set up webhooks to get those updates in real-time. This Connector is one of the many tools hosted on Vinkius that helps you keep your bot fleet running without the constant tab-switching. It gives you a direct way to monitor bot health and test your lead capture flows through simple conversation, so you can focus on the work that matters. For developers, this means you can quickly verify that a new connection is active or that a form is capturing the right JSON structure without manual testing. For marketing teams, it means you can automate the flow of leads from external sources and see how customers are interacting with your bot engine in real-time. It turns a manual, multi-tab process into a simple conversation where you can check statuses, inspect metadata, and verify configurations in a few seconds.

## Tools

### subscribe_webhook
This tool subscribes to bot events via webhooks. It lets you get real-time updates on user interactions sent to your bot engine.

### get_bot_status
This tool checks the operational status of your bots. Use it to see if a specific bot is currently online and responding to users.

### get_samples
This tool retrieves bot form field samples. It helps you see the data structure and required fields for your bot's contact forms.

### list_bots
This tool lists all the chatbots in your account. Use it to see every bot you have and their names in a single view.

### submit_contact
This tool submits data to the bot contact form. It allows you to programmatically send test lead data into your bot's submission system.

## Prompt Examples

**Prompt:** 
```
List all my bots and tell me which ones are offline.
```

**Response:** 
```
I've checked your account. Here is the current status of your bots:

| Bot Name | Status |
| :--- | :--- |
| Customer Support | **Online** |
| Sales Assistant | **Offline** |
| Lead Intake | **Online** |

It looks like the 'Sales Assistant' is currently down. Would you like me to check its connectivity details?
```

**Prompt:** 
```
What fields do I need to send for the 'Sales' bot contact form?
```

**Response:** 
```
I've retrieved the sample data for the 'Sales' bot form. You'll need to provide the following fields:

*   **first_name** (String)
*   **last_name** (String)
*   **email** (String)
*   **phone_number** (String)
*   **company_size** (Integer)

Would you like me to submit a test lead using these fields?
```

**Prompt:** 
```
Submit a test lead to the 'Support' bot with the name 'Test User' and email 'test@example.com'.
```

**Response:** 
```
I've submitted the test lead to your 'Support' bot.

**Submission Details:**
*   **Name:** Test User
*   **Email:** test@example.com

The data was sent successfully to the bot engine. You can check your internal dashboard to verify the log entry.
```

## Capabilities

### List all active chatbots
Show every bot in your account in a single view.

### Check bot online status
Verify if a specific bot is currently active and responding.

### Submit test lead data
Send test contact info to your bot forms to check the flow.

### Retrieve form field samples
See the exact data structure required by your bot's forms.

### Set up interaction webhooks
Get real-time updates on user interactions sent to your bot.

## Use Cases

### Testing a new lead form
A developer wants to know if the new 'Request a Demo' form works. They ask the agent to submit a test contact using submit_contact and check the logs.

### Checking fleet status
A support manager notices a drop in responses. They ask the agent to check the status of all bots using list_bots and get_bot_status to find the offline one.

### Understanding data structures
A marketer needs to map a third-party tool to a bot. They use get_samples to see what fields the bot expects so they can map the data correctly.

### Real-time monitoring
An ops lead wants to see how many people are hitting the 'Sales' bot. They use subscribe_webhook to get a live feed of interactions.

## Benefits

- Stop manual dashboard hopping by using list_bots to see your entire fleet in one place.
- Verify bot health instantly with get_bot_status to ensure your customer support is always active.
- Speed up development by using get_samples to see exactly what data your bot forms require.
- Test your lead capture logic without manual entry by using submit_contact to send test leads.
- Get real-time visibility into user behavior by setting up webhooks with subscribe_webhook.

## How It Works

The bottom line is you can manage and monitor your entire bot fleet through simple text commands.

1. Connect your The Botforge API Key to your AI client.
2. Ask your agent to list your bots or check a specific status.
3. Get real-time updates or submit test data through natural conversation.

## Frequently Asked Questions

**How does The Botforge MCP help with my chatbot management?**
It lets you control your bots using natural language. You can check statuses, submit test data, and get event updates without leaving your AI client.

**Can I use The Botforge MCP to see if my bots are actually online?**
Yes. You can ask your agent to check the status of any specific bot to see if it's active and responding to users right now.

**How do I test my lead capture forms with this Connector?**
You can ask your agent to submit a contact to a specific bot. It will send the data through the form so you can verify the flow works.

**Can I get real-time updates from my bots?**
Yes, you can use this to set up webhooks. This lets your agent receive updates on user interactions as they happen.

**Does The Botforge MCP work for multiple bots at once?**
It does. You can list every bot in your account and then query their individual statuses or configurations one by one.

**How does this save time for my marketing team?**
It removes the need to manually check form fields and submit test leads. Your team can just ask the agent to verify the setup for them.

**Can I check if a specific chatbot is online via AI?**
Yes! Use the `get_bot_status` tool and provide the Bot ID. Your agent will retrieve the current operational state of that specific bot.

**How do I submit data to my bot's contact form using the agent?**
Use the `submit_contact` action. Provide the contact details (name, email, message) in a JSON string. The agent will transmit this data directly to the bot engine.

**Is it possible to see which fields my bot expects in its form?**
Absolutely. Use the `get_samples` query. The agent will retrieve sample data based on your bot's configured form fields, helping you understand the required structure.