Gladly MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.6.3更新于 Nov 7, 2026

Find customers, read conversations, items and tasks; add internal notes in Gladly.

发布方自己的服务：Ably MCP by usefulapi

已验证Streamable HTTP可网页运行沟通与协作商业与电商

服务详情

标识符: io.usefulapi/gladly
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Oct 31, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此服务的命名空间属于 usefulapi.io，且该域名同时运行其端点。这可以确认发布者，但并不代表该服务的工具是安全的。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fgladly.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fgladly?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

面向 Gladly 客服系统的托管 MCP 服务器：查询客户、会话、时间线与任务，并可添加内部备注。

可以做什么: 按邮箱、电话或外部 ID 查找客户档案并读取详情
列出客户的会话与任务，读取单个会话、时间线条目和任务
列出组织、客服人员、收件箱、主题和受众等基础数据
为会话添加内部备注（唯一的写入工具）
查看用量、提交功能请求、升级或取消付费方案
适用场景: 适合客服与客户成功团队让助手在不切换工具的情况下调取 Gladly 中的客户历史、会话时间线和未结任务，或留下内部备注。
运行要求: 通过 streamable HTTP 连接的远程端点，无需本地安装。只需填写服务器地址并通过 OAuth 登录。首次连接时需提供 Gladly 组织、客服邮箱和 Gladly API 令牌，服务器按用户保存。免费方案每月 50 次工具调用。

安装前请注意

服务器会保存你的 Gladly 组织、客服邮箱和 API 令牌，可读取客户个人信息（姓名、邮箱、电话、地址）及会话内容。gladly_add_conversation_note 会写入 Gladly，每次调用都会新建一条备注，重复调用不会去重。付费方案通过 Stripe 结账链接收费，取消后当期不退款。

安装

在 SourceWeft 中

打开控制台中的 Gladly MCP by usefulapi，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fgladly/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "gladly-by-usefulapi": {
      "type": "http",
      "url": "https://gladly.usefulapi.io/mcp"
    }
  }
}

README

Gladly MCP by usefulapi

Use your Gladly account from Claude, Cursor, or any MCP client. Find customers, read conversations, items and tasks, and add internal notes. Hosted, no local install: connect with your own credentials.

Live endpoint: https://gladly.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://gladly.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http gladly https://gladly.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Gladly credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/gladly/

On first connect you provide your Gladly organization, an agent email and an API token (Gladly → Settings → API). The server validates them and stores them per user. No keys go in config files.

Tools

Tool	Type	What it does
`gladly_get_organization`	read	Get the organization
`gladly_list_agents`	read	List agents
`gladly_get_agent`	read	Get an agent
`gladly_list_inboxes`	read	List inboxes
`gladly_get_inbox`	read	Get an inbox
`gladly_list_topics`	read	List topics
`gladly_list_audiences`	read	List audiences
`gladly_find_customers`	read	Find customers
`gladly_get_customer`	read	Get a customer
`gladly_list_customer_conversations`	read	List conversations of a customer
`gladly_get_conversation`	read	Get a conversation
`gladly_list_conversation_items`	read	List the timeline of a conversation
`gladly_get_conversation_item`	read	Get a conversation item
`gladly_list_customer_tasks`	read	List tasks of a customer
`gladly_get_task`	read	Get a task
`gladly_add_conversation_note`	write	Add an internal note to a conversation
`gladly_usage_status`	meta	Usage status (free-tier meter)
`gladly_request_feature`	meta	Request a missing feature
`gladly_upgrade`	meta	Upgrade to Pro or Pro+
`gladly_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with gladly_upgrade (it returns a Stripe Checkout link). Cancel any time with gladly_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running gladly_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源：servers/gladly/README.md，提交 4046075

工具

gladly_get_organization

Get the organization

Get metadata about the Gladly organization: id, name, login domain, time zone, URL. Gladly API: GET /api/v1/organization.

无需输入参数。

gladly_list_agents

List agents

List the agents (support users) with id, name and email address. Gladly API: GET /api/v1/agents.

无需输入参数。

gladly_get_agent

Get an agent

Get one agent profile by id. Gladly API: GET /api/v1/agents/{agentId}.

输入参数agent_id必填

gladly_list_inboxes

List inboxes

List the inboxes with id, name and disabled state. Gladly API: GET /api/v1/inboxes.

无需输入参数。

gladly_get_inbox

Get an inbox

Get the metadata of one inbox by id. Gladly API: GET /api/v1/inboxes/{inboxId}.

输入参数inbox_id必填

gladly_list_topics

List topics

List the conversation topics (id, name, parentId, disabled). Use it to turn the topicIds of a conversation into names. Gladly API: GET /api/v1/topics.

无需输入参数。

gladly_list_audiences

List audiences

List the audiences used to target answers (id, name). Gladly API: GET /api/v1/audiences.

无需输入参数。

gladly_find_customers

Find customers

Find customer profiles by EXACTLY ONE identifier: email, phone number (E.164, for example +16505551987) or externalCustomerId. Returns at most 50 profiles, newest update first. Gladly API: GET /api/v1/customer-profiles.

输入参数emailphone_numberexternal_customer_id

gladly_get_customer

Get a customer

Get one customer profile by id: name, emails, phones, address, custom attributes. Gladly API: GET /api/v1/customer-profiles/{customerId}.

输入参数customer_id必填

gladly_list_customer_conversations

List conversations of a customer

List the conversations of one customer, oldest first (at most 100; the reply says if it was cut). Each has topics, status and assignee. Gladly API: GET /api/v1/customers/{customerId}/conversations.

输入参数customer_id必填

gladly_get_conversation

Get a conversation

Get the metadata of one conversation: assignee, inbox, topics, custom attributes, status. A merged conversation returns the surviving one. Gladly API: GET /api/v1/conversations/{conversationId}.

输入参数conversation_id必填

gladly_list_conversation_items

List the timeline of a conversation

List the timeline items of a conversation (messages, emails, calls, notes), oldest first, at most 1000. Gladly API: GET /api/v1/conversations/{conversationId}/items.

输入参数session_idconversation_id必填

gladly_get_conversation_item

Get a conversation item

Get one conversation item (message, email, note, call) by id. Gladly API: GET /api/v1/conversation-items/{itemId}.

输入参数item_id必填

gladly_list_customer_tasks

List tasks of a customer

List the tasks of one customer, newest first (at most 2000), optionally only OPEN or CLOSED. Gladly API: GET /api/v1/customers/{customerId}/tasks.

输入参数statuscustomer_id必填

gladly_get_task

Get a task

Get one task by id: body, assignee, due date, status, topics. Gladly API: GET /api/v1/tasks/{taskId}.

输入参数task_id必填

gladly_add_conversation_note

Add an internal note to a conversation

WRITE: add an internal note to a conversation. The note is for agents only; the customer does not see it. Each call adds a NEW note, so do not repeat a call that succeeded. Gladly API: POST /api/v1/conversations/{conversationId}/notes.

输入参数body必填conversation_id必填