# Landbot MCP

> Landbot MCP connects your AI agent directly to your conversational marketing platform. Stop using boring web forms; this allows you to build and manage sophisticated chatbot flows—whether for lead qualification, customer support, or proactive engagement across WhatsApp and Web. It lets you turn complex interactions into measurable data points.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** chatbot, conversational-marketing, lead-capture, whatsapp-automation, customer-engagement, workflow-automation

## Description

You're not just building a simple chat widget anymore. This MCP gives your AI agent the ability to handle full-scale conversation management, turning basic messaging into powerful lead generation tools. You can monitor every bot flow—from initial welcome message right through conversion metrics and drop-off points. Need to know what customers are talking about? Your agent pulls up all customer profiles and their entire history across channels like WhatsApp or web chat. Plus, you maintain visibility over your whole operation: check API statuses, list active bots, and even send proactive messages using templates. By connecting this MCP through Vinkius, your AI client gains the full context it needs to act like a true digital assistant, managing everything from lead capture to follow-up communication without you having to jump between dashboards.

## Tools

### handoff_to_agent
Transfers a customer conversation from the bot flow directly to an available human support agent.

### trigger_bot_flow
Starts a specific, pre-defined conversational path or bot flow for a user.

### get_account_info
Checks the current status and health of your Landbot API account connection.

### get_customer_details
Retrieves a complete profile, including stored properties, for any specified customer user.

### list_team_agents
Gets a list of all support agents currently available within your team setup.

### list_active_bots
Pulls a comprehensive list of every chatbot flow that is currently live and accessible.

### list_landbot_customers
Lists all recorded users who have interacted with your chatbots over time.

### list_message_hooks
Retrieves the configuration details for event hooks that monitor messages across different channels.

### send_proactive_image
Sends a specific image directly into a customer's chat conversation to guide them or provide information.

### send_proactive_text
Initiates a text message conversation with a customer, useful for general check-ins or updates.

### send_whatsapp_template
Sends structured, pre-approved messages to users specifically through the WhatsApp channel.

### update_customer_field
Changes a specific data field or property associated with a customer's profile in Landbot.

## Prompt Examples

**Prompt:** 
```
Show all bots with conversation counts and the latest customer conversations.
```

**Response:** 
```
Bots: 4. 'Lead Qualifier' (1.2K conversations, Web, 34% conversion ⭐). 'Support Bot' (890, Web+WhatsApp, 4.2 min avg). 'Onboarding' (345, Web). 'WhatsApp Sales' (567, WhatsApp, 28% conversion). Latest: 1) Ana — Lead Qualifier, 'Interested in Pro plan' (5 min ago). 2) Mike — Support, 'Password reset help' (12 min ago). 3) Lisa — WhatsApp Sales, 'Pricing question' (20 min ago).
```

**Prompt:** 
```
Show the conversation flow and analytics for the Lead Qualifier bot.
```

**Response:** 
```
Lead Qualifier flow: 6 steps. 1) Welcome (98% reach). 2) Company Size (92%). 3) Budget Range (85%). 4) Timeline (78%). 5) Contact Info (62%). 6) Meeting Booking (34% ✅). Drop-off: Step 4→5 (16%, budget sensitivity). Avg completion: 2.1 min. Leads captured: 408 this month. Qualified: 246 (60%). MQL→SQL conversion: 42%.
```

**Prompt:** 
```
List all customers and send a reply to Ana's conversation.
```

**Response:** 
```
Customers: 2,834 total. Active (7 days): 145. Channels: Web (1,890), WhatsApp (944). Top by conversations: Ana Costa (8 conversations), Mike Torres (5), Lisa Park (4). Reply sent to Ana! ✅ 'Hi Ana, great to hear you are interested in Pro! I will have our sales team reach out within the hour. In the meantime, here is our pricing page.'
```

## Capabilities

### View and manage all active bots
See a list of every chatbot flow you've built and track their overall performance.

### Retrieve customer profiles and history
Access detailed user records, including specific property fields and the full timeline of conversations they’ve had with your bots.

### Send proactive messages via multiple channels
Initiate targeted communications by sending chat images or formatted text directly to customers through WhatsApp templates or web chat.

### Handle human handoff and flow control
Trigger specific bot flows when needed, or smoothly transfer the conversation context to a live support agent for immediate help.

### Monitor platform health and setup
Check your account’s API status and view configurations for event hooks across all connected channels.

## Use Cases

### A lead needs follow-up after a demo
The sales team knows John Doe showed interest but hasn't responded in two days. Instead of emailing, they ask the agent to use send_proactive_text to send him a relevant link and check on his status, keeping the conversation history attached to his profile.

### Support needs to analyze bot failure points
The support lead wants to know why users fail at Step 4 of the onboarding flow. They ask the agent to list_active_bots and then examine the conversation metrics to pinpoint exactly which step causes the most drop-off.

### Marketing needs to segment leads instantly
A user just filled out a form, but their industry isn't clear. The marketing manager asks the agent to get_customer_details and then use update_customer_field to tag them immediately with the correct vertical for later segmentation.

### Sending urgent service updates via WhatsApp
The company needs to inform all users about a system outage. The agent uses send_whatsapp_template, ensuring the message meets WhatsApp's strict format requirements and gets delivered instantly.

## Benefits

- Stop guessing how well your funnels work. Use the bot management tools to list all available bots, check conversation metrics, and see where users are dropping out in real-time.
- Never lose context again. Get a full customer profile using get_customer_details, instantly seeing every interaction history across web chat or WhatsApp.
- Automate follow-ups that require manual effort. You can use send_proactive_text or send_whatsapp_template to reach out to leads immediately after they drop off the site.
- Improve service quality by streamlining handoffs. If a bot hits a wall, your agent can use handoff_to_agent to seamlessly pass the context to a live human teammate.
- Keep everything organized with list_landbot_customers. You get access to all users, which lets you target specific groups for marketing or support campaigns.

## How It Works

The bottom line is that you tell your AI client what you need, and it handles the complex API calls necessary to execute the action against Landbot.

1. Subscribe to this MCP on Vinkius and enter your Landbot API Token.
2. Your AI client uses the token to authenticate and access your entire bot infrastructure.
3. You prompt your agent, asking it to perform a task like 'List all bots' or 'Send a welcome message to John Doe,' and your agent executes the function.

## Frequently Asked Questions

**How do I check if my bot is working correctly with Landbot MCP?**
You can use list_active_bots to see all your current bots. If you suspect an issue, run get_account_info first to confirm the API connection is healthy.

**Can I send a message to a user who hasn't talked to me in months using Landbot MCP?**
Yes, you can use send_proactive_text or send_whatsapp_template. These tools allow you to initiate contact even if the user was dormant.

**What is the difference between list_landbot_customers and get_customer_details?**
list_landbot_customers gives you a master list of everyone who has talked to your bot. get_customer_details pulls up one person's specific, deep profile and conversation history.

**How do I pass a chat to a human agent?**
You use the handoff_to_agent tool. This automatically transfers all the current conversation context from the bot flow over to an available support team member.