Freshchat MCP by usefulapi
Find customers, read conversations and messages, list agents and groups, send replies in Freshchat.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin freshchat_list_user_conversations
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"freshchat": {
"url": "https://freshchat.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://freshchat.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
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.
Eingabe-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.
Eingabe-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}.
Eingabe-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.
Eingabe-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}.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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
Nachweis