# BotPenguin MCP for AI Agents AI Agent Connect

> BotPenguin MCP lets you manage your chatbots and live chat sessions directly from your AI agent. You can pull lead lists, check chat histories, and send automated messages or OTPs without switching tabs. It turns your AI into a customer support coordinator.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_LxHchejnXnjDmBn7iC6ClnwNayJGKbGxYsheI67o/ai-agent-connect
- **Tags:** chatbot-builder, lead-generation, whatsapp-automation, conversational-marketing, contact-management, customer-engagement

## Description

BotPenguin lets you handle your chatbot and live chat operations directly through your AI agent. You can pull lead lists, check chat histories, and send automated messages or OTPs without switching tabs. It turns your AI into a customer support coordinator. When you use this with the Vinkius catalog, you get access to over 4,000 tools from a single connection in your AI client. This means you can manage your chatbot data while also reaching other parts of your tech stack from one place. You can ask your agent to find a specific lead from last week, check what a customer was complaining about in a previous chat, or even trigger a verification code for a new signup. It takes the manual work out of lead routing and message monitoring. You can see who's waiting for a reply, who needs a follow-up, and what tags are currently active, making it easy to keep things moving without the usual tab-switching headache. You can also see which human agents are currently online and assign tasks more effectively. Instead of hunting through a dashboard to find a specific conversation, your agent can surface the exact details you need in seconds. This gives you a way to stay on top of your customers without the friction of jumping between different software windows. You can manage your entire conversational marketing strategy using simple natural language commands, making it feel like your AI agent is actually sitting at the support desk with you.

## Tools

### get_chat_history
Get the full message history for a specific chat. This helps you understand the context of a conversation before jumping in.

### get_contact
Pull the specific details for a single contact or lead. You can use this to quickly see a customer's information without leaving your chat.

### list_agents
See a list of all human operators and agents in your account. This makes it easy to see who is available to take over a conversation.

### list_chats
Pull a list of all active chat sessions. Use this to monitor live traffic and see which customers need a reply.

### list_contacts
Search for and list all contacts and leads collected by your chatbots. This gives you a quick way to browse your entire lead database.

### list_tags
See all the contact tags you've set up for lead categorization. It helps you keep your leads organized and properly routed.

### send_message
Send a message directly into an active chat to reply to a customer. This lets your agent handle responses programmatically or on your behalf.

### send_otp
Trigger a verification SMS code to a user's phone number to confirm their identity. This automates the security step for new signups or logins.

## Prompt Examples

**Prompt:** 
```
Show me the last 3 messages for chat session 456.
```

**Response:** 
```
Here is the recent history for session 456:

| User | Message |
| :--- | :--- |
| Customer | "I need help with my order." |
| Bot | "I can help with that. What is your order number?" |
| Customer | "It is ORD-9982." |
```

**Prompt:** 
```
Who are my active human agents right now?
```

**Response:** 
```
You have 3 agents currently online:

* **Sarah J.** (Support Tier 1)
* **Mike R.** (Sales)
* **Elena W.** (Technical Support)
```

**Prompt:** 
```
Send a verification code to +1234567890.
```

**Response:** 
```
Sent. The user should receive an OTP via SMS shortly.
```

## Capabilities

### Pull lead lists
Retrieve all contacts and leads collected by your chatbots.

### Check chat logs
View full message histories for specific conversations.

### Send messages
Push text directly into active chats to reply to customers.

### Verify users
Trigger OTP SMS messages to confirm phone numbers instantly.

### Monitor active chats
See which sessions are currently live and need attention.

### Manage team tags
List all configured tags and human agents for better routing.

## Use Cases

### Contextualizing past issues
A customer asks about a past order, but the agent doesn't have the history. Use get_chat_history to see what was said before and provide a consistent answer.

### Smart lead routing
A lead comes in but you don't know which team to assign them to. Use list_tags and list_agents to see your current setup and route the lead correctly.

### Automated phone verification
You need to verify a user's phone number during a signup flow. Ask your agent to send_otp to the user's number to confirm their identity immediately.

### Live chat monitoring
You're overwhelmed by new chats and don't know which ones are active. Use list_chats to see what's currently live and prioritize your responses.

## Benefits

- Stop switching tabs by accessing chat history and lead lists directly within your AI client.
- Speed up customer support by using send_message to reply to active inquiries instantly.
- Improve lead quality by pulling specific contact details using get_contact during conversations.
- Automate user verification by triggering send_otp messages without leaving your workspace.
- Keep track of your team by listing human agents and tags with list_agents and list_tags.
- Monitor live traffic more effectively by pulling active sessions with list_chats.

## How It Works

The bottom line is you get a direct line to your chatbot data and actions inside your AI client.

1. Get your BotPenguin API Token from your account settings.
2. Add the Connector to your client and paste the token.
3. Ask your agent to find leads, check chats, or send messages.

## Frequently Asked Questions

**Can I use BotPenguin MCP to see my leads?**
Yes, you can list all contacts and leads collected by your chatbots directly through your AI agent.

**Can my AI agent send messages to customers?**
Yes, it can send messages directly into active chats to help you respond to inquiries faster.

**Does BotPenguin MCP support WhatsApp?**
Yes, since it connects to BotPenguin, it manages your WhatsApp and web chat leads.

**How do I verify a user's phone number?**
You can have your agent trigger an OTP SMS via the Connector to confirm a user's identity instantly.

**Can I see my chat history?**
Yes, you can retrieve the full message history for any specific chat session to get full context.

**Can I manage my support team with this?**
Yes, you can list all configured human agents and tags to help with lead routing and team oversight.

**Can I search for a specific lead or contact by name?**
Yes! Use the `list_contacts` tool and provide the `search_text` parameter with the name, email, or details you are looking for. The agent will return the matching profiles.

**How do I review the chat history of a conversation?**
First, use `list_chats` to find the active or historical session. Then, use `get_chat_history` with the Chat ID to retrieve the full log of messages.

**Can I send an OTP SMS to a user?**
Yes. Use the `send_otp` action and provide the user's phone number (with the country code). BotPenguin will handle the integration to send the verification code.