# Cliengo MCP MCP

> Cliengo MCP manages conversational marketing and lead data directly through your AI agent. Quickly pull up full chat histories, review captured contact details from WhatsApp or chatbot conversations, and list all active leads without touching a dashboard. It gives you total visibility into the customer journey.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** chatbot, conversational-marketing, lead-capture, chat-history, customer-engagement, web-leads

## Description

Getting reliable insights from chatbots used to mean jumping between multiple tabs: checking the lead capture page, then switching over to the conversation history log, and finally pulling up the contact profile for verification. Now, your agent handles all of that in one natural chat session. You can ask it to pull a list of every lead captured today or check the full message exchange with a specific person from weeks ago. This means sales managers get real-time visibility into whether a prospect asked about pricing, and support agents can instantly verify what was discussed via chat history without logging into anything. Because Vinkius hosts this MCP in their catalog, you connect your agent once and gain access to all these lead data streams. You take full control of how you qualify leads using the conversational record.

## Tools

### get_contact_messages
Retrieves every single message exchanged with a particular customer or contact.

### get_lead_details
Pulls detailed profile information for any specific lead captured in the system.

### get_chat_history
Fetches the complete message transcript for a specific conversation thread.

### list_cliengo_users
Gets a list of all internal users and agents who manage conversations in your account.

### list_cliengo_leads
Retrieves a list of every lead and contact captured through the platform's chat tools.

### list_chat_conversations
Lists all current and past chatbot or WhatsApp conversations tracked by Cliengo.

### list_cliengo_webhooks
Displays details on configured webhooks used for sending real-time lead data.

### list_cliengo_websites
Lists all websites and projects where the Cliengo chatbot is installed and running.

## Prompt Examples

**Prompt:** 
```
List all new leads from Cliengo today.
```

**Response:** 
```
Retrieving today's leads... I found 5 new contacts: Juan Perez (WhatsApp), Maria Garcia (Chatbot), and 3 others. Would you like to see their details or chat history?
```

**Prompt:** 
```
Show me the chat history for Juan Perez.
```

**Response:** 
```
Checking messages for Juan Perez... He asked about 'Pricing Plans' and 'WhatsApp Integration' at 10:15 AM via the website chatbot. He left his phone number for a follow-up.
```

**Prompt:** 
```
List all internal users who manage my Cliengo account.
```

**Response:** 
```
Retrieving user list... Your account has 3 active users: Sarah Miller (Admin), Mike Scott (Agent), and Jane Doe (Agent). All are currently available to handle new conversations.
```

## Capabilities

### Review Conversation Records
Get the complete message history for any given chatbot or WhatsApp conversation.

### Audit Contact Messages
Pull up every single message ever exchanged with a specific contact, regardless of when it happened.

### Get Lead Profiles
Retrieve detailed information for any lead or contact captured by the chatbot system.

### List All Conversations
Pull up a list of every active chat conversation, including both chatbot and WhatsApp interactions.

### Check Captured Leads
Get a comprehensive list of all leads and contacts that Cliengo has captured.

### Monitor System Assets
Review the status of chatbot installations across different websites or projects.

## Use Cases

### The Cold Lead Follow-Up
A sales manager needs to know why a promising lead went silent. They ask the agent to use `get_contact_messages` for that contact, and immediately see three messages detailing an unresolved pricing question from two weeks ago.

### The Marketing Audit
A marketing analyst needs proof of lead sources for a new campaign. They ask to use `list_cliengo_leads` and filter by date, quickly reviewing all contacts captured since the UTM link was deployed.

### Onboarding New Support Staff
A manager needs to check if the chatbot is active on every client site. They use `list_cliengo_websites` and get a clear list of all projects, verifying coverage in minutes instead of hours.

### Webhook Health Check
The operations team needs to verify that the lead data is feeding into the central database. They ask to use `list_cliengo_webhooks` and check the status of all configured integrations.

## Benefits

- Never manually check multiple dashboards again. You can ask your agent to list all captured leads using `list_cliengo_leads` and get the data right where you are working.
- Need to know what a client talked about six months ago? Use `get_contact_messages` to pull up every message exchanged with them, instantly providing full context for support agents.
- Know if your chatbot is installed everywhere it should be. Run `list_cliengo_websites` to verify the status of all projects and websites in one query.
- Streamline lead qualification by listing and retrieving details for contacts using `get_lead_details`, allowing you to review their profile without leaving your workflow.
- Track who's doing what. You can use `list_cliengo_users` to see which internal agents manage conversations, ensuring proper team coverage.

## How It Works

The bottom line is you're getting access to Cliengo’s data streams right where you’re chatting with your AI client.

1. Subscribe to this MCP and enter your Cliengo API Key (you'll find this in your dashboard settings).
2. Connect it through your preferred AI client, like Cursor or Claude.
3. Ask your agent a natural language question, such as 'What were the last three messages from John Smith?' and get the answer instantly.

## Frequently Asked Questions

**How do I find out what a contact talked about using the get_contact_messages tool?**
You just tell your agent to use `get_contact_messages` and provide the specific contact's ID or name. It pulls up every message exchanged with that person, giving you the full backstory.

**What does list_cliengo_leads show me?**
`list_cliengo_leads` gives you a master list of all leads and contacts captured by Cliengo. This is your go-to tool for reviewing who came through the chatbot system.

**Can I check if my chatbot is running everywhere with list_cliengo_websites?**
Yes, `list_cliengo_websites` checks and lists every website or project where your Cliengo chatbot has been installed. This helps Ops teams verify coverage quickly.

**Is get_lead_details the right tool for checking a lead's current status?**
Yes, `get_lead_details` is exactly what you need. It pulls detailed information about a specific contact, giving you more than just their name.

**How do I check who manages my account using list_cliengo_users?**
It lists all internal users and agents set up in your Cliengo account. This helps you audit which team members have access to manage conversations.

**What does list_cliengo_webhooks show me about my setup?**
This tool displays every configured webhook for real-time lead data integration. Use it to confirm if your chat data is flowing correctly into other systems.

**If I just want a list of all active chats, should I use list_chat_conversations?**
Yes, this function gives you an index of every chatbot or WhatsApp conversation. It lets your AI agent quickly confirm activity without reviewing message history.

**What do I need to connect the MCP and run tools like get_lead_details?**
You must provide a valid Cliengo API Key. This key authorizes your AI client, granting secure access to all the data streams within the platform.

**Can I see what a specific customer said to the chatbot?**
Yes! Use the `get_contact_messages` tool with the contact ID. The agent will return the full message history for that specific lead, allowing you to review their questions and needs.

**How do I check which of my websites have Cliengo active?**
Use the `list_cliengo_websites` tool. Your agent will fetch all projects and websites registered in your account, including their configuration details.

**Where do I find my Cliengo API Key?**
Log in to Cliengo, navigate to **Settings**, and select **API**. You can find or generate your API key in that section.