> ## 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 **68 tools** across 15 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](/mcp/overview#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.          |

## All tools

### Identity

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

### Calls

| Tool                                                    | Scope      | Description                                                                   |
| ------------------------------------------------------- | ---------- | ----------------------------------------------------------------------------- |
| [`search_calls`](/mcp/tools/calls#search_calls)         | `mcp:read` | Search calls by date, rep, team, keyword, opportunity, CRM field, transcript. |
| [`get_call_details`](/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`](/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`](/mcp/tools/snippets#create_snippet) | `mcp:write` | Create a shareable clip from a call recording. |

### Teams

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

### Users & Roles

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

### Organization

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

### Scorecards

| Tool                                                                               | Scope                                   | Description                                         |
| ---------------------------------------------------------------------------------- | --------------------------------------- | --------------------------------------------------- |
| [`get_scorecards`](/mcp/tools/scorecards#get_scorecards)                           | `mcp:read`                              | List all scorecards.                                |
| [`get_scorecard_details`](/mcp/tools/scorecards#get_scorecard_details)             | `mcp:read`                              | Get a scorecard's full details and items.           |
| [`create_scorecard`](/mcp/tools/scorecards#create_scorecard)                       | `mcp:write`, **Admin**                  | Create a new scorecard.                             |
| [`update_scorecard`](/mcp/tools/scorecards#update_scorecard)                       | `mcp:write`, **Admin**                  | Update a scorecard's settings or criteria.          |
| [`create_scorecard_item`](/mcp/tools/scorecards#create_scorecard_item)             | `mcp:write`, **Admin**                  | Add a scoring criterion to a scorecard.             |
| [`update_scorecard_item`](/mcp/tools/scorecards#update_scorecard_item)             | `mcp:write`, **Admin**                  | Update a scoring criterion.                         |
| [`delete_scorecard_item`](/mcp/tools/scorecards#delete_scorecard_item)             | `mcp:write`, **Admin**, **Destructive** | Remove a scoring criterion.                         |
| [`update_scorecard_item_order`](/mcp/tools/scorecards#update_scorecard_item_order) | `mcp:write`, **Admin**                  | Reorder a scoring criterion.                        |
| [`update_scorecard_ranges`](/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`](/mcp/tools/labels#list_labels)                               | `mcp:read`                              | List label categories and their options.  |
| [`create_label`](/mcp/tools/labels#create_label)                             | `mcp:write`, **Admin**                  | Create a new label category.              |
| [`update_label`](/mcp/tools/labels#update_label)                             | `mcp:write`, **Admin**                  | Update a label category.                  |
| [`delete_label`](/mcp/tools/labels#delete_label)                             | `mcp:write`, **Admin**, **Destructive** | Delete a label category.                  |
| [`change_conversation_labels`](/mcp/tools/labels#change_conversation_labels) | `mcp:write`                             | Apply or update labels on a conversation. |

### Forecasting

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

### CRM

| Tool                                                              | Scope                                                            | Description                                                          |
| ----------------------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`get_crm_integrations`](/mcp/tools/crm#get_crm_integrations)     | `mcp:read`                                                       | List configured CRM integrations.                                    |
| [`create_crm_integration`](/mcp/tools/crm#create_crm_integration) | `mcp:write`, **Admin**                                           | Create a new CRM integration mapping.                                |
| [`update_crm_integration`](/mcp/tools/crm#update_crm_integration) | `mcp:write`, **Admin**                                           | Update a CRM integration's name, fields, or status.                  |
| [`sync_crm_fields`](/mcp/tools/crm#sync_crm_fields)               | `mcp:write`, **Admin**                                           | Force-sync entity and field definitions from the CRM.                |
| [`delete_crm_account`](/mcp/tools/crm#delete_crm_account)         | `mcp:write`, **Admin**, **Destructive**                          | Disconnect a CRM account and remove its integrations.                |
| [`connect_integration`](/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`](/mcp/tools/intelligence#list_intelligence_collections)   | `mcp:read`                              | List CRM prompt collections.      |
| [`create_intelligence_collection`](/mcp/tools/intelligence#create_intelligence_collection) | `mcp:write`, **Admin**                  | Create a new collection.          |
| [`update_intelligence_collection`](/mcp/tools/intelligence#update_intelligence_collection) | `mcp:write`, **Admin**                  | Update a collection.              |
| [`delete_intelligence_collection`](/mcp/tools/intelligence#delete_intelligence_collection) | `mcp:write`, **Admin**, **Destructive** | Delete a collection.              |
| [`list_intelligence_items`](/mcp/tools/intelligence#list_intelligence_items)               | `mcp:read`                              | List items in a collection.       |
| [`create_intelligence_item`](/mcp/tools/intelligence#create_intelligence_item)             | `mcp:write`, **Admin**                  | Add a new prompt to a collection. |
| [`update_intelligence_item`](/mcp/tools/intelligence#update_intelligence_item)             | `mcp:write`, **Admin**                  | Update an item.                   |
| [`delete_intelligence_item`](/mcp/tools/intelligence#delete_intelligence_item)             | `mcp:write`, **Admin**, **Destructive** | Delete an item.                   |

### API Keys

| Tool                                                   | Scope                                   | Description                                  |
| ------------------------------------------------------ | --------------------------------------- | -------------------------------------------- |
| [`list_api_keys`](/mcp/tools/api-keys#list_api_keys)   | `mcp:read`                              | List API keys (without tokens).              |
| [`create_api_key`](/mcp/tools/api-keys#create_api_key) | `mcp:write`, **Admin**                  | Create a new API key. Token shown only once. |
| [`delete_api_key`](/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`](/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`](/mcp/tools/super-agent#list_super_agent_sessions)             | `mcp:read`, **User-level**                   | List your super agent sessions.                                 |
| [`get_super_agent_session_history`](/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`](/mcp/tools/super-agent#cancel_super_agent_processing)     | `mcp:write`, **User-level**                  | Cancel an in-progress super agent run.                          |
| [`rename_super_agent_session`](/mcp/tools/super-agent#rename_super_agent_session)           | `mcp:write`, **User-level**                  | Rename a session.                                               |
| [`delete_super_agent_session`](/mcp/tools/super-agent#delete_super_agent_session)           | `mcp:write`, **User-level**, **Destructive** | Delete a session and its messages.                              |

### Reports

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