MCP Tools Reference

This article lists all tools exposed by the LiveAgent MCP server. The same tool set is available in both contexts:

  • Personal MCP connections (Bearer token or OAuth 2.1) — all tools are available automatically, subject to your role's permissions.
  • AI agent MCP connections — the administrator selects an allowed-tools subset when configuring the agent; tools not in that list are blocked even if the flow requests them.

For setup instructions, see MCP Integration for Agents (personal connections) or AI Agents feature overview (automated agents).

Read tools

ToolWhat it does
Get ticket messagesRetrieve ticket messages; omit the cursor for a full initial fetch, or provide a cursor to fetch only messages newer than a previous response
Get ticket metadataRead ticket properties such as subject, timestamps, status, priority, department, and assigned agent
Get tagsRead the tags currently applied to the ticket
Get ticket notesRetrieve internal ticket notes (agent notes, rule notes, API notes) with cursor-based pagination
Get ticket field definitionsRetrieve all ticket field definitions configured for the account, including type-specific metadata such as available values for list types
Get ticket field valuesRead all ticket field values for a given ticket, each returned with its definition metadata
List agentsRetrieve the list of agents available in the account (needed for assignment actions)
List departmentsRetrieve the list of departments (needed for transfer actions)
Search ticketsSearch for other tickets in the system to establish context

Write tools

ToolWhat it does
Add tagsApply one or more tags to the ticket
Remove tagsRemove one or more tags from the ticket
Add noteAdd an internal note to the ticket
Set ticket field valueSet a custom ticket field value; creates the value if missing, updates it if present and different
Delete ticket field valueRemove a custom ticket field value from the ticket
Submit ticket summarySubmit a generated AI summary for the ticket
Resolve ticketSet the ticket status to resolved
Reopen ticketReopen a previously resolved or answered ticket
Assign ticketAssign the ticket to a specific agent
Transfer ticketMove the ticket to a different department

Knowledge base tools

Read tools require the knowledgebase privilege; write tools (create and update) additionally require the knowledgebase content manage privilege.

ToolWhat it does
List knowledge basesList all knowledge bases in the account — use this first to discover knowledge base IDs required by other KB tools
List KB categoriesList knowledge base categories as a tree; optionally scoped to a parent category subtree
Search KB articlesSearch articles by keyword or phrase, optionally filtered to a category
Get KB articleRetrieve the full content of an article; each attachment includes a single-use download URL
Create KB articleCreate a new article with HTML content in a specified category
Update KB articleUpdate an article's title, body, status, visibility, or category; only fields you specify are changed
Create KB categoryCreate a new category or sub-category for organizing articles
Update KB categoryRename, move, reorder, or change the visibility of an existing category

×