Freshchat MCP by usefulapi

Find customers, read conversations and messages, list agents and groups, send replies in Freshchat.

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
89%
命名の品質
78%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(1)

  • LOWTool 'freshchat_list_user_conversations' name length outside 3-30 rangefreshchat_list_user_conversations 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~1,540トークン数(ツール定義)
~1.1 KB一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.20%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `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"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 10 件