Freshchat MCP by usefulapi
Find customers, read conversations and messages, list agents and groups, send replies in Freshchat.
Should I use this
Quality & Safety
Findings (1)
- LOWin freshchat_list_user_conversations
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"freshchat": {
"url": "https://freshchat.usefulapi.io/mcp"
}
}
}Remote endpoints
https://freshchat.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (10)
🟢freshchat_get_account
Get the Freshchat account configuration for the connected account. Good first call to confirm the connection. Freshchat API: GET /v2/accounts/configuration.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_list_users(first_name, last_name, email, reference_id, phone_no, ...)
Find customer users. The API needs at least one filter: first_name, last_name, email, reference_id or phone_no. Freshchat API: GET /v2/users.
Input Schema
{
"type": "object",
"properties": {
"first_name": {
"description": "Match users by first name.",
"type": "string"
},
"last_name": {
"description": "Match users by last name.",
"type": "string"
},
"email": {
"description": "Match users by e-mail address.",
"type": "string"
},
"reference_id": {
"description": "Match users by your own reference id.",
"type": "string"
},
"phone_no": {
"description": "Match users by phone number.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"items_per_page": {
"description": "Items per page (default 10, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"sort_by": {
"description": "Field to sort by, for example email or created_time.",
"type": "string"
},
"sort_order": {
"description": "Sort order (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_get_user(user_id)
Get one customer user by id, with e-mail, name, phone and custom properties. Freshchat API: GET /v2/users/{user_id}.
Input Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"minLength": 1,
"description": "The user id."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_list_user_conversations(user_id)
List the conversation ids of one customer user. Freshchat API: GET /v2/users/{user_id}/conversations.
Input Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"minLength": 1,
"description": "The user id."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_get_conversation(conversation_id)
Get one conversation: assignment, status, channel, users and properties. Freshchat API: GET /v2/conversations/{conversation_id}.
Input Schema
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"minLength": 1,
"description": "The conversation id."
}
},
"required": [
"conversation_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_list_messages(conversation_id, from_time, page, items_per_page)
List the messages of one conversation, oldest first. Use from_time to read only newer messages. Freshchat API: GET /v2/conversations/{conversation_id}/messages.
Input Schema
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"minLength": 1,
"description": "The conversation id."
},
"from_time": {
"description": "Only messages created at or after this UTC time, e.g. 2026-11-01T10:00:00.000Z.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"items_per_page": {
"description": "Items per page (default 10, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"required": [
"conversation_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴freshchat_send_message(conversation_id, text, user_id, actor_id)
Send a plain-text agent reply into a conversation. The customer sees it at once. Freshchat API: POST /v2/conversations/{conversation_id}/messages.
Input Schema
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"minLength": 1,
"description": "The conversation id."
},
"text": {
"type": "string",
"minLength": 1,
"description": "The message text to send."
},
"user_id": {
"description": "The customer user id the reply is for (from freshchat_get_conversation).",
"type": "string"
},
"actor_id": {
"description": "The agent id who sends the reply (from freshchat_list_agents).",
"type": "string"
}
},
"required": [
"conversation_id",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_list_agents(is_deactivated, page, items_per_page)
List support agents, with their groups, roles and availability. Freshchat API: GET /v2/agents.
Input Schema
{
"type": "object",
"properties": {
"is_deactivated": {
"description": "true for deactivated agents only, false for active agents only.",
"type": "boolean"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"items_per_page": {
"description": "Items per page (default 10, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_list_groups(page, items_per_page, sort_by, sort_order)
List agent groups (teams that conversations are assigned to). Freshchat API: GET /v2/groups.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"items_per_page": {
"description": "Items per page (default 10, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"sort_by": {
"description": "Field to sort by, for example name.",
"type": "string"
},
"sort_order": {
"description": "Sort order (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshchat_list_channels(locale)
List channels (topics) that new conversations are created under. Freshchat API: GET /v2/channels.
Input Schema
{
"type": "object",
"properties": {
"locale": {
"description": "ISO-639 language code, for example en or de. Filters channels by language.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence