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.
​
team_id
string
Filter labels by team ID. If omitted, returns all org labels.
​
label
string
Search labels by name (case-insensitive substring match).
​
ai_flow
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.
​
label
string
required
The name of the label category.
​
description
string
Description of what this label represents.
​
options
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.
​
ai_flow
boolean
Must be true for the label to appear in the UI and classify calls. Defaults to true.
​
all_teams
boolean
Apply to all teams. If false, use team_ids.
​
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.
​
label_id
string
required
The UUID of the label category.
​
label
string
New name.
​
description
string
New description. Set to empty string to clear.
​
options
array
Replace the classification options for this category.
​
ai_flow
boolean
Whether this category is active in AI classification.
​
all_teams
boolean
Apply to all teams.
​
team_ids
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.
​
label_id
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).
​
conversation_id
string
required
UUID of the conversation to label.
​
labels
object
required
Labels to set, as key-value pairs. Keys are label category names, values are the label values.Example:
{ "Call Type": "Discovery", "Outcome": "Positive" }
​
skip_analysis
boolean
Skip CRM intelligence refresh after the label change. Default: false.