Skip to main content
Labels are the classification system Attention’s AI uses to categorize calls (e.g. Call Type → Discovery, Demo, Negotiation). Each label category holds one or more options. Label categories can drive scorecard applicability, intelligence collection criteria, and reporting. This group covers reading the catalog, managing categories and options (admin), and applying labels to individual conversations.

​
Read tools

​
list_labels

Scope: mcp:read.
List label categories and their classification options. Each category contains options that Attention’s AI uses to classify calls.
​
string
Filter labels by team ID. If omitted, returns all org labels.
​
string
Search labels by name (case-insensitive substring match).
​
boolean
Filter by AI flow status. true = only AI-classified labels, false = only manual labels.
Returns: Markdown list of label categories with description, AI flow status, team scope, and options.

​
Category write tools

​
create_label

Scope: mcp:write. Requires admin role.
Create a new label category. A label category contains one or more options that Attention’s AI classifies calls into.
​
string
required
The name of the label category.
​
string
Description of what this label represents.
​
array
The classification options within this category. Each entry: { "value": "Pricing Discussion", "description": "Optional context for the AI" }. A label category needs at least one option to classify calls.
​
boolean
Must be true for the label to appear in the UI and classify calls. Defaults to true.
​
boolean
Apply to all teams. If false, use team_ids.
​
array
Team IDs this label applies to. Ignored if all_teams is true.

​
update_label

Scope: mcp:write. Requires admin role.
Update an existing label category, including its classification options. Omitted fields preserve current values. Note that options is replace-all — providing it overwrites every existing option.
​
string
required
The UUID of the label category.
​
string
New name.
​
string
New description. Set to empty string to clear.
​
array
Replace the classification options for this category.
​
boolean
Whether this category is active in AI classification.
​
boolean
Apply to all teams.
​
array
Team IDs this label applies to.

​
delete_label

Scope: mcp:write. Requires admin role. Destructive.
Delete a label category and all its options. This is permanent.
​
string
required
The UUID of the label category to delete.

​
Conversation labels

​
change_conversation_labels

Scope: mcp:write.
Apply or update labels on a specific conversation. Labels are passed as a key-value map where keys are label category names (use list_labels to see them).
​
string
required
UUID of the conversation to label.
​
object
required
Labels to set, as key-value pairs. Keys are label category names, values are the label values.Example:
​
boolean
Skip CRM intelligence refresh after the label change. Default: false.