Skip to content
MCP server

Gladly MCP by usefulapi

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

Install
Runs
Remotely
Version
1.10.0
Listing updated
4 days ago

About Gladly MCP by usefulapi

Gladly MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http gladly https://gladly.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://gladly.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gladly": {
      "url": "https://gladly.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gladly": {
      "type": "http",
      "url": "https://gladly.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gladly": {
      "serverUrl": "https://gladly.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (16)

Read directly from the server.

gladly_get_organization
Get metadata about the Gladly organization: id, name, login domain, time zone, URL. Gladly API: GET /api/v1/organization.
gladly_list_agents
List the agents (support users) with id, name and email address. Gladly API: GET /api/v1/agents.
gladly_get_agent
Get one agent profile by id. Gladly API: GET /api/v1/agents/{agentId}.
gladly_list_inboxes
List the inboxes with id, name and disabled state. Gladly API: GET /api/v1/inboxes.
gladly_get_inbox
Get the metadata of one inbox by id. Gladly API: GET /api/v1/inboxes/{inboxId}.
gladly_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 the audiences used to target answers (id, name). Gladly API: GET /api/v1/audiences.
gladly_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.
gladly_get_customer
Get one customer profile by id: name, emails, phones, address, custom attributes. Gladly API: GET /api/v1/customer-profiles/{customerId}.
gladly_list_customer_conversations
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.
gladly_get_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}.
gladly_list_conversation_items
List the timeline items of a conversation (messages, emails, calls, notes), oldest first, at most 1000. Gladly API: GET /api/v1/conversations/{conversationId}/items.
gladly_get_conversation_item
Get one conversation item (message, email, note, call) by id. Gladly API: GET /api/v1/conversation-items/{itemId}.
gladly_list_customer_tasks
List the tasks of one customer, newest first (at most 2000), optionally only OPEN or CLOSED. Gladly API: GET /api/v1/customers/{customerId}/tasks.
gladly_get_task
Get one task by id: body, assignee, due date, status, topics. Gladly API: GET /api/v1/tasks/{taskId}.
gladly_add_conversation_note
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.

Gladly MCP by usefulapi FAQ

How do I add Gladly MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http gladly https://gladly.usefulapi.io/mcp