Model Context Protocol (MCP)

The Text Model Context Protocol (MCP) server enables AI assistants to interact with Text features and data directly. This integration allows AI agents to perform real-time customer support operations and automate workflows without manual intervention.

What is MCP?

Model Context Protocol is an open standard that enables AI assistants to connect to external tools and data sources securely. Text’s MCP server is built upon our Workflows feature and provides functions that let AI agents take various actions in the Text ecosystem. In practice, this means an AI assistant can perform tasks such as replying to a chat, updating a ticket, or pulling a report, all within the context and permissions of a real user. All actions are limited by your token scopes and your Text account permissions, including access to tickets.

How MCP works

Text hosts a remote MCP server that follows the authenticated MCP specification. When an AI tool or application connects to this server, the interaction flows as follows:

Connect: The AI assistant, or client application, initiates a connection to the Text MCP server at the given URL.
Authenticate: The user is authenticated. The connection uses the same access controls as their Text account.
Authorize and interact: Once authenticated, the AI assistant can invoke the available tools (API-like actions) to retrieve or manipulate Text data within your permissions.
Live connection: The MCP connection remains open to stream results and receive real-time updates as needed. This allows AI assistants to maintain context and respond promptly.

Connecting to Text MCP

Text provides integrations for Claude and ChatGPT. You can also connect compatible MCP clients directly to https://mcp.text.com/v2/. Each connection uses your Text account and respects your permissions.

Claude

Connect Claude to Text through the Text integration in Claude’s directory.

ChatGPT

Connect ChatGPT to Text through the Text integration in ChatGPT’s plugin directory.

Using MCP-remote

The Text MCP external server supports public authentication for all compatible MCP clients. External clients connect via mcp-remote to the public endpoint:

MCP URL
`https://mcp.text.com/v2/`

To start mcp-remote, you must specify a local port. The MCP client is then configured to connect to the local address using the chosen port. You can connect to Text MCP through the following ports:

6274
53531
59123
60222

Configuration example

Below is a generic example of an mcp-remote OAuth connection. Setup details may vary between versions and providers, so always refer to your specific LLM provider’s official documentation for the most up-to-date configuration instructions.

{
  "mcpServers": {
    "text": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.text.com/v2/", "<port>"]
    }
  }
}

User permissions

All actions and data access are limited to the authenticated user’s roles, teams, and resource permissions. AI assistants connected through MCP use the same security model as the user.

Available MCP tools

The external Text MCP server exposes a predefined set of tools that an AI assistant can use. Each tool maps to one or more Text API calls. Access depends on the scopes required by those APIs, your account roles, and your resource permissions. For general rules on scopes, see Scopes. The below tools represent the external MCP capabilities.

Chats

Method	Description	Required scope
`chats-ban-customer`	Ban a customer for a number of days, blocking them from starting new chats.	`customers.ban:rw`
`chats-end-chat`	Close (deactivate) a chat, ending its active thread.	`chats--access:rw`
`chats-get-agent-status`	Get agents’ routing statuses: accepting chats, not accepting chats, or offline.	`routing_read` and `agents-bot--all:ro`
`chats-get-chat`	Get the full structured details of a chat, including properties, access, users, and thread.	`chats--access:ro`
`chats-get-inactivity`	Check how long a chat has gone without an agent or customer message, against a threshold.	`chats--all:ro`
`chats-get-transcript`	Get a chat’s conversation as a readable transcript.	`chats--access:ro`
`chats-list-agents`	List every agent with access to chats, including ID, display name, avatar, and bot flag.	`agents--all:ro`
`chats-list-archived`	List archived (closed) chats, with optional filtering by agent, group, customer, or date range.	`chats--access:ro`
`chats-list-groups`	List every chat group (routing queue), including ID, name, and language.	`groups--all:ro`
`chats-list-tags`	List every chat tag, including its name and the group IDs it’s assigned to.	`tags--all:ro`
`chats-send-message`	Send a message from the agent into a chat.	`chats--access:rw`
`chats-supervise`	Join a chat as an invisible supervisor, without appearing to the customer.	`chats--access:rw`
`chats-tag-chat`	Apply a tag to a specific thread of a chat.	`chats--access:rw`
`chats-transfer`	Transfer a chat to another agent or group.	`chats--access:rw`

Tickets

Ticket tools require an agent or administrator role and access to the relevant resources.

Method	Description
`tickets-add-followers`	Add followers to a ticket.
`tickets-add-tags`	Add tags to a ticket.
`tickets-create`	Create a new ticket.
`tickets-create-transaction`	Create an upload transaction, used to attach files to a ticket message before sending it.
`tickets-find`	Find an existing ticket by its ID.
`tickets-list`	List tickets, with optional filtering by status, priority, requester email, or source.
`tickets-list-agents`	List every ticketing agent, including ID, account ID, email, and avatar URL.
`tickets-list-brief`	List tickets by ID and subject line only.
`tickets-list-tags`	List every ticket tag, including its ID and name.
`tickets-mark-spam`	Move a ticket to spam.
`tickets-remove-followers`	Remove followers from a ticket.
`tickets-remove-tags`	Remove tags from a ticket.
`tickets-send-message`	Send a message to a ticket, visible to the requester or private to agents.
`tickets-set-custom-fields`	Set custom field values on a ticket.
`tickets-summarize`	Summarize a ticket’s conversation.
`tickets-update`	Update an existing ticket’s subject, status, priority, assignment, tags, followers, or message.

Customers

Method	Description	Required scope
`customers-add-event`	Add a tracking event to a customer’s timeline.	`customers:rw`
`customers-get`	Get a customer’s full profile, including monitoring info, statistics, tickets, identities, and custom properties.	`customers:ro`
`customers-list`	List customers, with optional filtering by active status or group IDs.	`customers:ro`
`customers-set-data`	Set custom data fields on a customer.	`customers:rw`
`customers-set-properties`	Set values for defined customer properties.	`customers:rw`
`customers-update`	Update a customer’s identity fields, such as name, email, avatar, or phone number.	`customers:rw`

Agents

Method	Description	Required scope
`agents-resolve`	Resolve an agent’s identity across accounts and ticketing, given an email or ID.	`accounts--all:ro`

Accessing ticketing agents with agents-resolve also requires an agent or administrator role and the relevant resource permissions.

Reports

Method	Description	Required scope
`reports-get`	Fetch one report for a time range, with optional filters.	`reports_read`
`reports-compare`	Fetch one report for two periods and return both series plus the deltas between them.	`reports_read`
`reports-combine`	Fetch several reports for one period and merge them by date into one table.	`reports_read`
`reports-list`	List the report types available through reports-get, reports-compare, and reports-combine.	`reports_read`

Language detection

Method	Description	Required scope
`text-detect-language`	Detect the language of a piece of text.	None

Getting started

Key concepts

API overview

Authentication

What is MCP?

How MCP works

Connecting to Text MCP

Claude

ChatGPT

Using MCP-remote

Configuration example

User permissions

Available MCP tools

Chats

Tickets

Customers

Agents

Reports

Language detection

​What is MCP?

​How MCP works

​Connecting to Text MCP

​Claude

​ChatGPT

​Using MCP-remote

​Configuration example

​User permissions

​Available MCP tools

​Chats

​Tickets

​Customers

​Agents

​Reports

​Language detection

What is MCP?

How MCP works

Connecting to Text MCP

Claude

ChatGPT

Using MCP-remote

Configuration example

User permissions

Available MCP tools

Chats

Tickets

Customers

Agents

Reports

Language detection