# Freshchat MCP for AI Agents AI Agent Connect

> Freshchat MCP lets you connect your customer support platform to your AI agent. It handles sending messages, pulling user profiles, and tracking active chats so you don't have to jump between tabs. It's built for teams who need to manage high-volume support conversations without the manual overhead of constant context switching.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_PkP7uansx6hNtFxuENUb8zNJxaJRxMQaD0Sjgiqu/ai-agent-connect
- **Tags:** live-chat, messaging, customer-profiles, conversation-management, support-automation

## Description

This Connector puts your Freshchat data right in front of your AI agent. Instead of switching back and forth between your support dashboard and your workspace, you can just ask your agent to find a specific customer or check a conversation status. It pulls in real-time details like user profiles, active chat lists, and agent availability. You can use it to see who is online, pull up a history of what a customer was saying, or have your agent post a reply directly to a live chat. It's about making your support workflow a conversation rather than a series of clicks. Because Vinkius hosts this in a unified catalog, you get it running alongside your other tools without having to manage separate connections for every single service. It works across your web, mobile, and social channels to keep your team moving. You can verify your account configuration or explore your channel routing to ensure your team is set up for success. It turns your support queue into a dynamic data source that your agent can query on demand.

## Tools

### check_account_status
Verifies your Freshchat account configuration. Use this to make sure your connection is active and correct.

### get_agent_profile
Pulls metadata for a specific support agent. Use this to see who is handling a specific task.

### get_conversation_details
Fetches metadata for a single chat. This helps you see the status and context of a specific conversation.

### get_chat_user_details
Retrieves specific metadata for a chat participant. Use it to see the details of the person you're talking to.

### list_chat_users
Lists all participants in a conversation. Use this to see everyone involved in a group chat.

### search_chat_users
Finds a user by their email address. This is the fastest way to pull up a specific customer's data.

### send_chat_message
Posts a new message to an existing conversation. Use this to have your agent reply to a customer directly.

### list_support_agents
Lists all agents in your system. This is great for seeing who is online and ready to take a chat.

### list_chat_channels
Shows all configured chat channels. Use this to understand how your messages are being routed.

### list_conversations
Lists all currently active chats. This lets you see the volume of open tickets at a glance.

### list_agent_groups
Lists the different groups of agents. Use this to understand your internal team structure.

### list_chat_messages
Retrieves all messages within a specific chat. This is perfect for getting the full history of a conversation.

## Prompt Examples

**Prompt:** 
```
Who is currently online and ready to take a chat?
```

**Response:** 
```
### Online Support Agents

| Agent Name | Status | Group |
| :--- | :--- | :--- |
| Sarah Jenkins | **Online** | Tier 1 Support |
| Marcus Chen | **Online** | Technical Support |
| Elena Rodriguez | **Away** | Tier 1 Support |

There are currently 2 agents available to take new chats immediately.
```

**Prompt:** 
```
Find the customer with email support@company.com and tell me their last 3 messages.
```

**Response:** 
```
### Customer Profile: Alice Smith
- **ID:** user_abc123
- **Status:** Active

**Recent Messages:**
1. "I am having trouble accessing my dashboard."
2. "Can you help me reset my password?"
3. "I've tried the reset link but it's not arriving."
```

**Prompt:** 
```
Reply to conversation conv_123 saying 'We are looking into your refund now'.
```

**Response:** 
```
✅ **Message Sent!**

Your update has been posted to conversation `conv_123`. The customer will see your reply in their chat widget immediately.
```

## Capabilities

### Send live chat replies
Post new messages to existing conversations to keep your support workflows moving fast.

### Find customers by email
Search for specific users by their email address to pull up their profiles instantly.

### List active conversations
Get a list of all current chats to see what needs attention right now.

### Check agent availability
List all support agents to see who is online and ready to help customers.

### Pull conversation history
Retrieve the full message history for any specific conversation ID for audit and reporting.

### View user profile details
Access detailed profile information for chat participants to get better context.

### List chat channels
Access configured messaging channels to understand your routing logic.

## Use Cases

### Checking agent availability during peak hours
A support lead asks the agent to list_support_agents to see who is currently online and available to take new tickets.

### Retrieving customer history for a refund
A customer success manager asks the agent to search_chat_users by email and then list_chat_messages to see previous interactions.

### Sending quick follow-up messages
A sales engineer asks the agent to send_chat_message to a specific conversation ID to thank a lead for their time.

### Auditing conversation metadata
A manager asks the agent to list_conversations and get_conversation_details to check the status of high-priority tickets.

## Benefits

- Stop jumping between tabs by using list_conversations to see everything in one place.
- Get instant context on customers by using search_chat_users to pull up profiles by email.
- Reply to customers faster by using send_chat_message to post updates directly from your agent.
- Keep your team organized by using list_support_agents to see who is online and available.
- Audit past interactions easily by using list_chat_messages to pull the full history of a conversation.
- Understand your routing logic by using list_chat_channels and list_agent_groups to see how chats move.

## How It Works

The bottom line is you get a direct line from your AI agent to your Freshchat support queue.

1. Subscribe to the Freshchat MCP on the Vinkius Marketplace.
2. Enter your Freshchat Region Domain and API Token from your account settings.
3. Ask your AI client to list active chats or send a message to a customer.

## Frequently Asked Questions

**Can the Freshchat MCP help me manage my support team?**
Yes, it lets you list all support agents and their groups. You can quickly see who is online and available to help customers without leaving your workspace.

**How do I find a specific customer using this Connector?**
You can ask your agent to search for a customer by their email address. It will pull up their profile details so you have the right context for the conversation.

**Can I send messages to my customers through the AI?**
Yes, you can have your AI client post new messages directly to existing conversations. This makes it much faster to provide updates or answers.

**Does this work for multiple regions?**
Yes, it supports various data centers including the US, EU, IN, and AU. You just need to provide your specific region domain during setup.

**Can I see the history of a past chat?**
Absolutely. You can request the full message history for any specific conversation ID, which is great for auditing or catching up on old tickets.

**How does this help with customer success?**
It helps customer success managers get a real-time overview of customer interactions and pull up user profiles quickly to stay informed during calls or chats.

**How do I get an API Token for Freshchat?**
Log in to Freshchat, navigate to Settings > API Tokens, and click on 'Generate Token' to retrieve your Bearer Token.

**What is my 'Region Domain'?**
Your domain depends on where your account is hosted (e.g. 'api.freshchat.com' for US, 'api.eu.freshchat.com' for Europe).

**Can I send files or images through the agent?**
Currently, the 'send_chat_message' tool focuses on sending text content. Supporting rich media typically requires separate upload operations.

**Is it possible to see the chat history of a customer?**
Yes! Use the 'list_chat_messages' tool and provide the Conversation ID. The agent will retrieve the historical message history for that thread.