# Chaport MCP MCP

> Chaport. Manage all live chat and customer messaging directly from your AI agent. This MCP lets you track site visitors, pull full chat history, send messages to active chats, and monitor every operator's status without leaving your workspace.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** visitor-tracking, customer-messaging, real-time-chat, support-automation, visitor-intelligence, helpdesk

## Description

Connect Chaport to your preferred AI client to run your entire support operation through natural conversation. You can now get a complete picture of customer activity—from listing recent website visitors to reviewing the full message history for any chat session. Need to know if an agent is free? Check the live status board instantly, or retrieve detailed profiles on agents and users right from your prompt. This connector means you handle customer engagement and team oversight all in one place. When you connect this MCP via Vinkius, your AI client knows exactly how to access every piece of necessary support data.

## Tools

### get_chat_history
Retrieves all messages and events that occurred during a specific customer's chat.

### get_my_agent_profile
Pulls data about the agent who is currently authenticated with the system.

### get_visitor_last_chat
Retrieves the content of a visitor's most recent conversation session.

### get_visitor_details
Fetches detailed information for any given website visitor.

### list_online_agents
Returns a list of agents who are currently marked as online and available for chat.

### list_chaport_operators
Lists every single operator account configured within your Chaport workspace.

### list_website_visitors
Provides a list of people who recently visited your website, including key metadata.

### send_agent_message
Sends a specific message to a visitor within an active or past chat thread.

## Prompt Examples

**Prompt:** 
```
List all website visitors from the last hour.
```

**Response:** 
```
Retrieving recent visitors... I found 5 visitors, including 'John Doe' (john@example.com) and 4 anonymous guests. Would you like to see the details for any of them?
```

**Prompt:** 
```
Which support agents are currently online in Chaport?
```

**Response:** 
```
Checking agent status... Currently, 2 operators are online: Sarah Miller and Mike Scott. The other 3 agents are currently offline.
```

**Prompt:** 
```
Show me the message history for chat ID 123456.
```

**Response:** 
```
Retrieving history for chat 123456... I found 10 events, including 4 messages from the visitor and 3 replies from Sarah Miller. Would you like to see the transcript?
```

## Capabilities

### View recent website visitors
Get a list of people who visited the site recently and see their contact information.

### Monitor agent availability
Check which support staff are online right now, or get a full roster of every operator on the team.

### Access chat transcripts
Pull up the complete message history and all events for any specific customer conversation.

### Send messages to visitors
Directly send a follow-up message into an active or past visitor's chat session.

## Use Cases

### Handling an unknown visitor complaint
A customer complains about pricing. Instead of asking them for their email, the agent first calls `list_website_visitors` to find their contact info. Then it uses `get_visitor_details` and `get_visitor_last_chat` to confirm if they’ve asked that question before, allowing a perfectly informed response.

### Preparing for an internal team meeting
The Support Manager needs metrics. They ask the agent to run `list_chaport_operators` and then check who is available by calling `list_online_agents`. This provides a live count of capacity without leaving the chat interface.

### Following up after an abandoned cart
A user left the site. The agent calls `get_visitor_details` to pull their email and then uses `send_agent_message` to send a gentle reminder about the item they were looking at.

### Auditing team efficiency
The Business Owner wants to check support coverage. They run `list_chaport_operators` and then use `get_my_agent_profile` to verify their own permissions, giving them a quick overview of who's on staff.

## Benefits

- Stop searching multiple tabs. You get full context—like calling `get_visitor_details` or `list_website_visitors`—and the data shows up instantly in your chat agent, letting you respond faster.
- Manage your team's load without asking anyone. Running `list_online_agents` tells you who's free right now, so you can direct incoming chats immediately.
- Never lose context on a customer. You can run `get_chat_history` to pull up the full conversation thread and send targeted follow-ups using `send_agent_message`.
- Streamline your reporting. Instead of opening a dashboard, ask your agent for an audit trail by calling `list_chaport_operators` or checking your own status via `get_my_agent_profile`.
- Quickly jump back into conversations. Use `get_visitor_last_chat` to get the gist of what happened last time, so you don't have to read a mountain of old logs.

## How It Works

The bottom line is, your AI agent handles all the API calls for you, giving you support insights without manual dashboard navigation.

1. Subscribe to this MCP and provide your Chaport API Token, which you grab from the platform settings.
2. Connect your AI agent to the Vinkius catalog via your preferred client (like Cursor or Claude).
3. Start asking questions in natural language. Your agent runs the necessary tool calls—like listing visitors or retrieving chat history—and gives you a clear answer.

## Frequently Asked Questions

**How do I use `list_website_visitors` in Chaport?**
You ask your agent to list recent visitors by asking a question like, 'Show me the last 10 people who visited.' The tool then retrieves and lists their contact info directly.

**Can I check operator status with `list_online_agents`?**
Yes. You ask your agent to list online agents, and it returns a real-time count of staff available right now, telling you who can take the next chat.

**What is `get_chat_history` for in Chaport?**
`get_chat_history` lets your agent pull up every message and event from a specific past conversation. You just need to provide the unique chat ID.

**How do I send a follow-up using `send_agent_message`?**
You prompt your agent with an instruction like, 'Send John Doe a message saying X.' The tool executes that action and sends the message directly into the chat.

**When I run `list_chaport_operators`, does it show me all my agents, even those who are currently offline?**
Yes. This tool provides a full roster of every agent in your account, regardless of their current online status. You can use this to audit team membership or check for dormant accounts that need attention.

**If I use `get_visitor_details`, is there a way to quickly pull the context from their last conversation as well?**
You can combine calls to build full visitor profiles. After running `get_visitor_details` for basic info, you should immediately follow up with `get_visitor_last_chat`. This sequence gives your agent both the contact data and the most recent conversational context.

**What happens if I hit a rate limit when calling `get_chat_history`?**
If you receive a rate limiting error, stop calling the function immediately. Wait for a specified period (usually 60 seconds) before retrying the call to prevent further API errors.

**Does using `get_visitor_details` require specific permissions beyond just having an active token?**
Yes, your associated Chaport account needs read access enabled for visitor data. If you get a permission denied error when calling `get_visitor_details`, check with your support manager to confirm the correct API scope is applied.

**Can I see who is currently visiting my website?**
Yes! Use the `list_website_visitors` tool. The agent will return a list of recent and active visitors, including their names, emails, and location if available.

**How do I reply to a specific customer chat?**
Use the `send_agent_message` tool with the unique chat ID. Your agent will post the message directly into the Chaport conversation.

**Where do I generate my Chaport API Token?**
Log in to your Chaport account and go to **Settings → API**. You can generate and copy your API token from that section.