> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attention.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools Reference

> Flat, searchable index of every tool exposed by the Attention MCP server with its scope and a one-line description.

The Attention MCP server (v1.7.0) exposes **82 tools** across 17 functional groups. The table below lists every tool with its scope and a one-line description; click the tool name to jump to its full reference.

For a grouped overview, see the [Overview](https://docs.attention.com/mcp/overview.md#whats-available).

## Scope legend

| Marker | Meaning |
| - | - |
| `mcp:read` | Read-only tool. Available to OAuth tokens with the read scope and to any API key. |
| `mcp:write` | Mutating tool. Requires the write scope. |
| **Admin** | Additionally requires the admin role on the authenticated user. |
| **User-level** | Cannot be called with org-level API keys; needs OAuth or a user-level API key. |
| **Org-level** | Requires an org-level API key; OAuth tokens and user-level API keys are not allowed. |
| **Destructive** | Permanently removes data or cannot be reversed without manual intervention. |
| **Builder** | Requires the admin or Product role, and Agent Builder enabled for the organization. |

## All tools

### Identity

| Tool | Scope | Description |
| - | - | - |
| [`get_me`](https://docs.attention.com/mcp/tools/identity#get_me) | `mcp:read` | Get the authenticated user, org, and roles. |

### Calls

| Tool | Scope | Description |
| - | - | - |
| [`search_calls`](https://docs.attention.com/mcp/tools/calls#search_calls) | `mcp:read` | Search calls by date, rep, team, keyword, opportunity, CRM field, transcript. |
| [`get_call_details`](https://docs.attention.com/mcp/tools/calls#get_call_details) | `mcp:read` | Get a single call's transcript, scorecard results, and insights. |

### AI Analysis

| Tool | Scope | Description |
| - | - | - |
| [`ask_attention`](https://docs.attention.com/mcp/tools/ai-analysis#ask_attention) | `mcp:read` | Run AI analysis across up to 25 calls or all calls in a deal. |

### Snippets

| Tool | Scope | Description |
| - | - | - |
| [`create_snippet`](https://docs.attention.com/mcp/tools/snippets#create_snippet) | `mcp:write` | Create a shareable clip from a call recording. |

### Teams

| Tool | Scope | Description |
| - | - | - |
| [`list_teams`](https://docs.attention.com/mcp/tools/teams#list_teams) | `mcp:read` | List all teams and the team hierarchy. |
| [`get_team`](https://docs.attention.com/mcp/tools/teams#get_team) | `mcp:read` | Get a single team's details and sub-teams. |
| [`get_team_members`](https://docs.attention.com/mcp/tools/teams#get_team_members) | `mcp:read` | List the members of a team with their roles. |
| [`create_team`](https://docs.attention.com/mcp/tools/teams#create_team) | `mcp:write`, **Admin** | Create a new team. |
| [`update_team`](https://docs.attention.com/mcp/tools/teams#update_team) | `mcp:write`, **Admin** | Rename a team or change its parent. |
| [`archive_team`](https://docs.attention.com/mcp/tools/teams#archive_team) | `mcp:write`, **Admin** | Archive or unarchive a team (reversible). |
| [`change_team_parent`](https://docs.attention.com/mcp/tools/teams#change_team_parent) | `mcp:write`, **Admin** | Move a team under a new parent or make it top-level. |
| [`add_team_member`](https://docs.attention.com/mcp/tools/teams#add_team_member) | `mcp:write`, **Admin** | Add a user to a team. |
| [`remove_team_member`](https://docs.attention.com/mcp/tools/teams#remove_team_member) | `mcp:write`, **Admin** | Remove a user from a team. |

### Users & Roles

| Tool | Scope | Description |
| - | - | - |
| [`list_reps`](https://docs.attention.com/mcp/tools/users-roles#list_reps) | `mcp:read` | List users in the org with optional filters. |
| [`list_roles`](https://docs.attention.com/mcp/tools/users-roles#list_roles) | `mcp:read` | List org roles with their type. |
| [`list_invitations`](https://docs.attention.com/mcp/tools/users-roles#list_invitations) | `mcp:read` | List pending invitations. |
| [`update_user`](https://docs.attention.com/mcp/tools/users-roles#update_user) | `mcp:write`, **Admin** | Update a user's profile, role, or seat type. |
| [`update_user_teams`](https://docs.attention.com/mcp/tools/users-roles#update_user_teams) | `mcp:write`, **Admin** | Add/remove team memberships in one call. |
| [`manage_user_role`](https://docs.attention.com/mcp/tools/users-roles#manage_user_role) | `mcp:write`, **Admin** | Assign or remove a role for a user. |
| [`delete_user`](https://docs.attention.com/mcp/tools/users-roles#delete_user) | `mcp:write`, **Admin**, **User-level** | Soft-delete (deactivate) a user. Reversible via `reactivate_user`. |
| [`reactivate_user`](https://docs.attention.com/mcp/tools/users-roles#reactivate_user) | `mcp:write`, **Admin** | Reactivate a previously deactivated user. |
| [`invite_user`](https://docs.attention.com/mcp/tools/users-roles#invite_user) | `mcp:write`, **Admin**, **User-level** | Send an email invitation to a new user. |
| [`update_invitation`](https://docs.attention.com/mcp/tools/users-roles#update_invitation) | `mcp:write`, **Admin**, **User-level** | Update a pending invitation's seat type. |
| [`delete_invitation`](https://docs.attention.com/mcp/tools/users-roles#delete_invitation) | `mcp:write`, **Admin**, **User-level**, **Destructive** | Delete a pending invitation. |

### Organization

| Tool | Scope | Description |
| - | - | - |
| [`get_org_overview`](https://docs.attention.com/mcp/tools/organization#get_org_overview) | `mcp:read` | Get a summary of roles and team structure. |
| [`update_org_settings`](https://docs.attention.com/mcp/tools/organization#update_org_settings) | `mcp:write`, **Admin** | Update org-wide settings (call joining, bot image). |

### Scorecards

| Tool | Scope | Description |
| - | - | - |
| [`get_scorecards`](https://docs.attention.com/mcp/tools/scorecards#get_scorecards) | `mcp:read` | List all scorecards. |
| [`get_scorecard_details`](https://docs.attention.com/mcp/tools/scorecards#get_scorecard_details) | `mcp:read` | Get a scorecard's full details and items. |
| [`create_scorecard`](https://docs.attention.com/mcp/tools/scorecards#create_scorecard) | `mcp:write`, **Admin** | Create a new scorecard. |
| [`update_scorecard`](https://docs.attention.com/mcp/tools/scorecards#update_scorecard) | `mcp:write`, **Admin** | Update a scorecard's settings or criteria. |
| [`create_scorecard_item`](https://docs.attention.com/mcp/tools/scorecards#create_scorecard_item) | `mcp:write`, **Admin** | Add a scoring criterion to a scorecard. |
| [`update_scorecard_item`](https://docs.attention.com/mcp/tools/scorecards#update_scorecard_item) | `mcp:write`, **Admin** | Update a scoring criterion. |
| [`delete_scorecard_item`](https://docs.attention.com/mcp/tools/scorecards#delete_scorecard_item) | `mcp:write`, **Admin**, **Destructive** | Remove a scoring criterion. |
| [`update_scorecard_item_order`](https://docs.attention.com/mcp/tools/scorecards#update_scorecard_item_order) | `mcp:write`, **Admin** | Reorder a scoring criterion. |
| [`update_scorecard_ranges`](https://docs.attention.com/mcp/tools/scorecards#update_scorecard_ranges) | `mcp:write`, **Admin** | Update min/middle/max for all items in a scorecard. |

### Labels

| Tool | Scope | Description |
| - | - | - |
| [`list_labels`](https://docs.attention.com/mcp/tools/labels#list_labels) | `mcp:read` | List label categories and their options. |
| [`create_label`](https://docs.attention.com/mcp/tools/labels#create_label) | `mcp:write`, **Admin** | Create a new label category. |
| [`update_label`](https://docs.attention.com/mcp/tools/labels#update_label) | `mcp:write`, **Admin** | Update a label category. |
| [`delete_label`](https://docs.attention.com/mcp/tools/labels#delete_label) | `mcp:write`, **Admin**, **Destructive** | Delete a label category. |
| [`change_conversation_labels`](https://docs.attention.com/mcp/tools/labels#change_conversation_labels) | `mcp:write` | Apply or update labels on a conversation. |

### Forecasting

| Tool | Scope | Description |
| - | - | - |
| [`get_forecast_config`](https://docs.attention.com/mcp/tools/forecasting#get_forecast_config) | `mcp:read` | Get forecast categories. |
| [`create_forecast_category`](https://docs.attention.com/mcp/tools/forecasting#create_forecast_category) | `mcp:write`, **Admin** | Create a new forecast category. |
| [`update_forecast_category`](https://docs.attention.com/mcp/tools/forecasting#update_forecast_category) | `mcp:write`, **Admin** | Update a forecast category. |

### CRM

| Tool | Scope | Description |
| - | - | - |
| [`get_crm_integrations`](https://docs.attention.com/mcp/tools/crm#get_crm_integrations) | `mcp:read` | List configured CRM integrations. |
| [`create_crm_integration`](https://docs.attention.com/mcp/tools/crm#create_crm_integration) | `mcp:write`, **Admin** | Create a new CRM integration mapping. |
| [`update_crm_integration`](https://docs.attention.com/mcp/tools/crm#update_crm_integration) | `mcp:write`, **Admin** | Update a CRM integration's name, fields, or status. |
| [`sync_crm_fields`](https://docs.attention.com/mcp/tools/crm#sync_crm_fields) | `mcp:write`, **Admin** | Force-sync entity and field definitions from the CRM. |
| [`delete_crm_account`](https://docs.attention.com/mcp/tools/crm#delete_crm_account) | `mcp:write`, **Admin**, **Destructive** | Disconnect a CRM account and remove its integrations. |
| [`connect_integration`](https://docs.attention.com/mcp/tools/crm#connect_integration) | `mcp:write`, **User-level** (admin for CRM, write for Microsoft) | Generate an OAuth link to connect Salesforce, HubSpot, or Microsoft. |

### Intelligence

| Tool | Scope | Description |
| - | - | - |
| [`list_intelligence_collections`](https://docs.attention.com/mcp/tools/intelligence#list_intelligence_collections) | `mcp:read` | List CRM prompt collections. |
| [`create_intelligence_collection`](https://docs.attention.com/mcp/tools/intelligence#create_intelligence_collection) | `mcp:write`, **Admin** | Create a new collection. |
| [`update_intelligence_collection`](https://docs.attention.com/mcp/tools/intelligence#update_intelligence_collection) | `mcp:write`, **Admin** | Update a collection. |
| [`delete_intelligence_collection`](https://docs.attention.com/mcp/tools/intelligence#delete_intelligence_collection) | `mcp:write`, **Admin**, **Destructive** | Delete a collection. |
| [`list_intelligence_items`](https://docs.attention.com/mcp/tools/intelligence#list_intelligence_items) | `mcp:read` | List items in a collection. |
| [`create_intelligence_item`](https://docs.attention.com/mcp/tools/intelligence#create_intelligence_item) | `mcp:write`, **Admin** | Add a new prompt to a collection. |
| [`update_intelligence_item`](https://docs.attention.com/mcp/tools/intelligence#update_intelligence_item) | `mcp:write`, **Admin** | Update an item. |
| [`delete_intelligence_item`](https://docs.attention.com/mcp/tools/intelligence#delete_intelligence_item) | `mcp:write`, **Admin**, **Destructive** | Delete an item. |

### API Keys

| Tool | Scope | Description |
| - | - | - |
| [`list_api_keys`](https://docs.attention.com/mcp/tools/api-keys#list_api_keys) | `mcp:read` | List API keys (without tokens). |
| [`create_api_key`](https://docs.attention.com/mcp/tools/api-keys#create_api_key) | `mcp:write`, **Admin** | Create a new API key. Token shown only once. |
| [`delete_api_key`](https://docs.attention.com/mcp/tools/api-keys#delete_api_key) | `mcp:write`, **Admin**, **Destructive** | Revoke an API key permanently. |

### Super Agent

| Tool | Scope | Description |
| - | - | - |
| [`send_super_agent_message`](https://docs.attention.com/mcp/tools/super-agent#send_super_agent_message) | `mcp:write`, **User-level** | Send a message to the super agent (sync up to 15s, then async). |
| [`list_super_agent_sessions`](https://docs.attention.com/mcp/tools/super-agent#list_super_agent_sessions) | `mcp:read`, **User-level** | List your super agent sessions. |
| [`get_super_agent_session_history`](https://docs.attention.com/mcp/tools/super-agent#get_super_agent_session_history) | `mcp:read`, **User-level** | Get message history (used to poll for async responses). |
| [`cancel_super_agent_processing`](https://docs.attention.com/mcp/tools/super-agent#cancel_super_agent_processing) | `mcp:write`, **User-level** | Cancel an in-progress super agent run. |
| [`rename_super_agent_session`](https://docs.attention.com/mcp/tools/super-agent#rename_super_agent_session) | `mcp:write`, **User-level** | Rename a session. |
| [`delete_super_agent_session`](https://docs.attention.com/mcp/tools/super-agent#delete_super_agent_session) | `mcp:write`, **User-level**, **Destructive** | Delete a session and its messages. |

### Agent Builder

| Tool | Scope | Description |
| - | - | - |
| [`create_agent_flow`](https://docs.attention.com/mcp/tools/agent-builder#create_agent_flow) | `mcp:write`, **Builder** | Create an agent and its empty flow; returns `agent_id` and `flow_id`. |
| [`get_flow`](https://docs.attention.com/mcp/tools/agent-builder#get_flow) | `mcp:read`, **Builder** | Read a flow's trigger, steps, inputs and current issues. |
| [`get_piece_schema`](https://docs.attention.com/mcp/tools/agent-builder#get_piece_schema) | `mcp:read`, **Builder** | Look up a piece's exact action, trigger and property ids. |
| [`get_action_options`](https://docs.attention.com/mcp/tools/agent-builder#get_action_options) | `mcp:write`, **Builder** | Resolve a dropdown's values against a connected account. |
| [`set_trigger`](https://docs.attention.com/mcp/tools/agent-builder#set_trigger) | `mcp:write`, **Builder**, **Destructive** | Set what fires the flow, replacing the current trigger. |
| [`add_step`](https://docs.attention.com/mcp/tools/agent-builder#add_step) | `mcp:write`, **Builder** | Insert a piece action step. |
| [`add_loop_step`](https://docs.attention.com/mcp/tools/agent-builder#add_loop_step) | `mcp:write`, **Builder** | Add a loop that runs its body once per list element. |
| [`add_router_step`](https://docs.attention.com/mcp/tools/agent-builder#add_router_step) | `mcp:write`, **Builder** | Add a router with condition and fallback branches. |
| [`add_code_step`](https://docs.attention.com/mcp/tools/agent-builder#add_code_step) | `mcp:write`, **Builder** | Add a JavaScript step for reshaping data. |
| [`update_step`](https://docs.attention.com/mcp/tools/agent-builder#update_step) | `mcp:write`, **Builder**, **Destructive** | Change a step's input, action, connection or code. |
| [`delete_step`](https://docs.attention.com/mcp/tools/agent-builder#delete_step) | `mcp:write`, **Builder**, **Destructive** | Remove a step and anything nested inside it. |
| [`test_step`](https://docs.attention.com/mcp/tools/agent-builder#test_step) | `mcp:write`, **Builder** | Run one step (reads only) and show its output. |
| [`validate_flow`](https://docs.attention.com/mcp/tools/agent-builder#validate_flow) | `mcp:read`, **Builder** | Return the flow's blocking and advisory issues. |

### Reports

| Tool | Scope | Description |
| - | - | - |
| [`get_usage_report`](https://docs.attention.com/mcp/tools/reports#get_usage_report) | `mcp:read`, **Org-level** | Per-user activity metrics for a date range (calls, coaching, AI usage). |

### Proactive

| Tool | Scope | Description |
| - | - | - |
| [`list_proactive_actions`](https://docs.attention.com/mcp/tools/proactive#list_proactive_actions) | `mcp:read` | Each rep's suggested next best actions; managers and admins see their reps' headers. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.