Messaging

Freshchat MCP Server

Connect your account, then chat with AI to run tools.

Freshchat is a messaging platform that enables businesses to communicate with their customers through chat, providing tools for real-time support and engagement. It is used to enhance customer interactions and improve customer support efficiency.

26 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Freshchat — workflow patterns, data models, and gotchas for your AI agent.

Freshchat

Freshchat is a messaging platform that enables businesses to communicate with their customers through chat, providing tools for real-time support and engagement. It is used to enhance customer interactions and improve customer support efficiency.

Data Model

  • Directory objects — accounts, agents, channels, groups, and end-users each expose stable ids for subsequent filters.
  • Conversations — threaded chats scoped to a user; capture conversation_id before reading transcripts.
  • Messaging — outbound/inbound payloads, plus CSAT capture tied to resolved conversations.
  • Reporting — scheduled extracts, on-demand report downloads, and live queue metrics.

Gotchas

  • Subdomain: Long format (e.g. thinkchain-ca403ef148e04bd17635627). No .freshchat.com.
  • Writes are live: creating or updating users, agents, conversations, or messages mutates the tenant—pair experiments with explicit cleanup paths.

Tools in this Server (26)

Fetch

Universal fetch tool that retrieves ANY Freshchat resource using smart ID routing with colon-separated format. Supports account, users, agents, conver...

Freshchat Check Business Hours

Check if a group is currently within business hours. Returns boolean indicating whether the group is within business hours at the current instant. Use...

Freshchat Create Csat

Submit a CSAT (Customer Satisfaction) rating for a resolved conversation. Use this to record customer feedback and satisfaction scores. Returns CSAT r...

Freshchat Delete Agent

Permanently delete an agent from Freshchat. CAUTION: This is a GDPR-compliant permanent deletion. All agent data will be removed and cannot be recover...

Freshchat Delete User

Permanently delete a user from Freshchat. CAUTION: This is a GDPR-compliant permanent deletion. All user data, conversations, and history will be remo...

Freshchat Extract Report

Request extraction of a Freshchat report. Reports contain raw metrics data for analysis. Returns report_id and link. Use fetch_report to check status ...

Freshchat Fetch Conversations

Retrieve detailed information for a specific conversation using conversation_id. Ideal for monitoring or analyzing a particular interaction. Returns c...

Freshchat Fetch Conversations Messages

Get messages from a specific conversation by conversation_id. Use this when you need a message-by-message view of a chat session. Returns message cont...

Freshchat Fetch Report

Get report status and download links for an extracted report. Returns report status (COMPLETED/PENDING/FAILED), time interval, and S3 download links. ...

Freshchat Get Historical Metrics

Retrieve historical dashboard metrics from Freshchat. Returns metrics accurate up to 5 minutes before current time. Supports CSAT metrics, conversatio...

Freshchat Get Instant Metrics

Retrieve real-time instant metrics from Freshchat dashboard. Returns metrics at the current instant (accurate up to real-time). Shows agent presence, ...

Freshchat List Account

Retrieve configuration settings of your Freshchat account. Useful for understanding account-wide configurations and settings. Returns details like acc...

Freshchat List Agents

Enumerate all agents available in your Freshchat organization with filtering. Use this to manage agent assignments, monitor availability, or find agen...

Freshchat List Channels

List all communication channels (topics) in your Freshchat account with filtering. Use this to configure or modify channel settings, find channels by ...

Freshchat List Conversations Properties

Access all conversation properties and field definitions in your Freshchat service. Useful for configuring fields or understanding conversation metada...

Freshchat List Groups

Retrieve lists of groups within your Freshchat setup. Useful for organizing agents and managing group-specific engagements. Returns group names, IDs, ...

Freshchat List Roles

Access a list of roles defined in your Freshchat account. Ideal for role management and permissions review. Returns role names, IDs, descriptions, and...

Freshchat List Users

List users from your Freshchat platform with advanced filtering. REQUIRES at least one filter parameter (the API does not support listing all users). ...

Freshchat List Users Conversations

Fetch conversations for a specific user indicated by user_id. Useful for reviewing or managing the user's conversation history. Returns array of conve...

Freshchat Send Message

Send a message to a conversation. Supports plain text, rich content (images, files), and interactive elements (quick reply buttons, URL buttons, carou...

Freshchat Upload File

Upload a file to Freshchat storage for use as attachments in messages. Returns file_hash, file_name, file_size, content_type, and security status. Use...

Freshchat Upload Image

Upload an image to Freshchat storage. Returns image URL, thumbnail URL, dimensions (width/height), and content type. Use the image URL in message_part...

Freshchat Upsert Agent

Create a new agent or update an existing agent in Freshchat. If id is provided, updates the agent. If id is omitted, creates a new agent (email requir...

Freshchat Upsert Conversation

Create a new conversation or update an existing conversation in Freshchat. If id is provided, updates conversation (status, assignment, properties). I...

Freshchat Upsert User

Create a new user or update an existing user in Freshchat. If id is provided, updates the user (partial update - only specified fields are changed). I...

Search

Search across multiple Freshchat resources using a single query. Searches users, conversations, and agents. Returns results with colon-routed IDs for ...

Frequently Asked Questions

What is the Freshchat MCP server?

Freshchat is a messaging platform that enables businesses to communicate with their customers through chat, providing tools for real-time support and engagement. It is used to enhance customer interactions and improve customer support efficiency. It provides 26 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Freshchat to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/freshchat. Authentication is handled automatically.

How many tools does Freshchat provide?

Freshchat provides 26 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Freshchat require?

Freshchat uses API Key. Freshchat requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Freshchat to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/freshchat

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to use Freshchat?

Sign in to connect your credentials and start running tools from the chat.

Freshchat MCP Server & Skill — 26 Tools