# Crisp MCP MCP

> Crisp MCP handles real-time support communication and visitor context retrieval. Use this to list active chats, get full message transcripts for any session, or pull detailed profiles on website visitors. It lets you automate responses and track customer history directly through your agent.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** crisp, live-chat-api, omnichannel-support, messaging-automation, visitor-intelligence, conversation-tracking, customer-engagement, helpdesk-automation, mcp

## Description

Stop bouncing between chat dashboards, email inboxes, and CRM records just to answer one question. This MCP connects all your multi-channel support data into a single stream of conversation context. You can instantly list every active web chat session or pull the full message history for any thread, giving you immediate insight into what the visitor talked about last week or five minutes ago. Need to know who you're talking to? Fetch detailed profiles on visitors, including their activity and status. If your agent needs to update a billing system after support, it can chain this MCP with a different service—that's where Vinkius shines. Because we keep all credentials passing through a zero-trust proxy, you know your keys never sit on disk while building complex automations that span multiple platforms.

## Tools

### get_conversation
Retrieves high-level summary information for a specific chat session.

### get_messages
Lists the full, chronological content of messages within any given conversation thread.

### get_visitor_profile
Pulls detailed records about a specific person who visited your website.

### list_conversations
Generates a list of all ongoing and archived support chats on the site.

### list_visitors
Provides an enumeration of every known person who has visited your website.

### send_message
Sends a direct, actionable message into an active chat conversation.

## Prompt Examples

**Prompt:** 
```
List all active conversations on my website.
```

**Response:** 
```
I've retrieved your active conversations. You have 3 open chats, including an inquiry from 'John' and a question about 'Premium Features'. Would you like the message history for any of these?
```

**Prompt:** 
```
Show the transcript for chat session 'sess_123'.
```

**Response:** 
```
Fetching transcript... Session sess_123 details a discussion about 'Setup Guides'. The visitor requested a link to the documentation, and Agent Sarah replied 10 minutes ago. Shall I draft a follow-up?
```

**Prompt:** 
```
Find the visitor profile for 'jane@example.com'.
```

**Response:** 
```
I've located Jane's profile. She has visited the pricing page 3 times today and is currently tagged as a 'VIP Lead'. Would you like to see her full conversation history?
```

## Capabilities

### List active chats
See every current and past chat session running on your website.

### Retrieve conversation transcripts
Fetch the complete message history for a specific support thread.

### Get visitor details
Access personal and behavioral data about any known website user.

### Send messages to sessions
Programmatically send follow-up messages directly into an active chat session.

## Use Cases

### Handling a complex support ticket
A user asks their agent about a billing discrepancy. The agent first uses list_conversations to find the right thread, then get_visitor_profile to confirm account details, and finally gets_messages to review previous troubleshooting steps before drafting an accurate response.

### Reacting to abandoned carts
A marketing analyst sees a high-value visitor who hasn't been active in days. They use list_visitors to find the record, and then send_message to trigger a personalized follow-up chat message offering help.

### Auditing support volume
An ops manager needs to know how many chats were open at midnight last night. They use list_conversations to quickly pull the necessary status reports without manually checking the dashboard.

### Onboarding a new team member
A trainer wants to demonstrate context gathering. They ask their agent to get_messages for a specific session, showing how easily the AI can summarize long threads for training purposes.

## Benefits

- Don't waste time hunting through threads. Use get_messages to instantly pull complete message histories for any session, giving your agent the precise background needed for a perfect response.
- Never start from scratch with a customer. The MCP allows you to fetch detailed visitor profiles using get_visitor_profile, so your agent knows their name, past activity, and status right away.
- Automate follow-up communication. If an issue is resolved, use send_message to keep the loop closed by sending immediate updates without human intervention.
- Keep track of everything that's happening on site. list_conversations gives you a real-time view of all open support chats, so nothing gets missed in high-volume periods.
- Gain full visibility into your customer interactions. Because this MCP runs on Vinkius, you get an audit trail for every tool call and data point that passes through the agent.

## How It Works

The bottom line is, instead of manually logging into Crisp, you just ask your AI client for the information it needs.

1. First, you'll need your Plugin ID, Plugin Key, and Website ID from the Crisp dashboard. You pass those credentials to your AI agent.
2. Next, tell your agent what you need—for example, 'List all open support chats.' The MCP runs the request against the live Crisp data.
3. Finally, your agent gets back structured data, like a list of conversations or a full visitor profile, ready for you to use in your next prompt.

## Frequently Asked Questions

**How do I list all active chats using the get_conversation tool?**
You use list_conversations to see an overview of every chat. This gives you conversation IDs, which you then pass to get_conversation if you need more detail on a specific session.

**Can I send messages using the send_message tool?**
Yes, send_message lets your agent reply directly to an active chat. It's perfect for automated follow-ups or confirming next steps without human intervention.

**What data does get_visitor_profile provide?**
It pulls detailed records on the person, including their visit history and current status tags. This is better than just looking at a name because it provides context about their intent.

**Is list_visitors reliable for finding old customer data?**
list_visitors gives you an enumeration of people who visited, which helps track volume and identity. For deep history, combine this with get_messages to pull the specific transcript needed.

**If I need the full transcript for a session, how do I use the get_messages tool?**
The get_messages tool retrieves every message sent within a specific conversation thread. It gives you the complete history, allowing your agent to provide context far beyond just the latest activity summary.

**What is the scope of conversations I can monitor using list_conversations?**
list_conversations provides an overview of all website support sessions. You can use this data to check statuses and get IDs for both active chats and recently closed threads.

**When sending a message, what format does the send_message tool require?**
The send_message tool requires you to pass all data as a single JSON string. You must structure your payload precisely for it to correctly dispatch assistance to an active chat session.

**Does list_visitors handle pagination when I need many people records?**
list_visitors returns batches of visitor data, and you will likely need to loop through the results. Your agent can process these pages sequentially to gather comprehensive lists of your user base.