Freshchat MCP by usefulapi
Find customers, read conversations and messages, list agents and groups, send replies in Freshchat.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWfreshchat_list_user_conversations에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"freshchat": {
"url": "https://freshchat.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://freshchat.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거