Attention

Ensure a library folder path exists. Reuse the returned Path—not the folder ID—as create_snippet's library_folder_path. Existing folders are returned unchanged; missing levels in nested paths like "Demos/Enterprise" are created without duplicate siblings.

Create a new scorecard for evaluating calls. A scorecard defines how Attention's AI scores calls against specific criteria. After creating, add scoring items with create_scorecard_item. Use criteria to filter which calls the scorecard applies to (based on label categories). Requires admin access.

Add a scoring criterion to a scorecard. Each item defines what the AI evaluates on a numeric scale (e.g. 1-5). Use get_scorecard_details to see existing items. Requires admin access.

Create a shareable snippet from a call recording. Specify start_time and end_time to clip a time range, or omit both to use the full recording.

Create a new team in your organization. Teams organize users and control which calls, scorecards, and labels apply to them. Use list_teams to see existing teams. Requires admin access.

Revoke an API key permanently. Any integrations using this key will stop working immediately. Use list_api_keys to find key IDs. Requires admin access.

Disconnect a CRM account and remove all its integrations. This action is irreversible. Requires admin access.

Delete a forecast category. System-managed categories (computed from CRM deal stages) cannot be deleted. This is permanent. Requires admin access.

Delete a CRM prompt collection. This is permanent. Requires admin access.

Delete a CRM prompt/field from its collection. This is permanent. Requires admin access.

Delete a pending invitation. Only pending (not yet accepted) invitations can be deleted. Requires admin access and user-level authentication.

Delete a label category and all its options. This is permanent. Use list_labels to find label IDs. Requires admin access.

Delete a scorecard and its scoring items. This is permanent. Will be refused with a conflict error if scorecard results already reference this scorecard — prefer disabling via update_scorecard (enabled:false) for non-destructive removal in that case, or delete the results first. Requires admin access.

Remove a scoring criterion from a scorecard. Use get_scorecard_details to find item IDs. Requires admin access.

Permanently delete a snippet you own. Admins can delete any snippet in the organization. Use the snippet ID returned from create_snippet.

Delete a super agent session and all its messages.

Deactivate (soft-delete) a user. The user loses access but can be reactivated later. Use list_reps to find user IDs. Requires admin access and user-level authentication.

Get details for a single call including its full transcript, scorecard results, and insights. Use this when the user wants to read or see the transcript. Set detailed_transcript=true for a structured transcript with speaker names and timestamps. For analysis across multiple calls, use ask_attention instead.

List CRM integrations configured for your organization, including platform details, sync status, and entity field mappings. Requires admin access.

Get the forecast categories configured for your organization, including column types, display order, and visibility settings. Requires admin access.

Check the status of an integration workflow run previously started by push_conversation_crm_fields. Returns 'complete' (workflow finished successfully), 'failed' (with the CRM validation / API error message extracted from the workflow), or 'processing' (still running). This is a fast probe — call it as often as the LLM client needs to. Requires mcp:read.

Get your own user profile including name, email, role, and team memberships. Use this to understand who you are authenticated as.

Get a summary of your organization including roles and team structure.

Get detailed information about a specific scorecard including its criteria, weights, team assignments, and evaluation instructions.

List all scorecards used to evaluate calls in your organization, including their criteria and which teams they apply to.

Get the message history for a super agent session. Returns all user and assistant messages (excluding internal tool results). Use this to poll for the assistant's response after send_super_agent_message returns with status 'processing'. Check if the last message has role 'assistant' to determine if the response is ready. Super-agent messages are final synthesized output — treat them as authoritative rather than raw data to re-summarize.

Get details about a specific team including sub-teams. Use the team ID from list_teams results.

List all members of a specific team. Use the team ID from list_teams results.

Get a usage report showing activity metrics per user for a given date range. Metrics include coaching sessions, calls viewed, comments left, snippets created, AI insights ran, and Super Agent usage. Requires an org-level API key.

Invite a user to your organization by email. The user will receive an email invitation to join the specified team with the given role. Requires admin access and user-level authentication.

List all API keys in your organization. Keys are shown with masked tokens for security. Use this to find key IDs for deletion. Requires admin access.

List all CRM prompt collections in your organization. Each collection defines which CRM prompts apply to calls matching its label-based criteria.

List all CRM prompts/fields in an intelligence collection. Shows titles, prompts, response types, and options.

List all label categories and their classification options. Each category contains options that Attention's AI uses to classify calls.

List a library folder and its immediate children so you can navigate by folder ID and choose a valid library_folder_path for create_snippet. Omit folder_id for the organization root (or the personal root when my_library is true).

List all users (reps, managers, admins) in your organization. Optionally filter by email or team.

List all roles defined in your organization with their type (admin, manager, sales_rep). Use this to understand your organization's role structure before assigning roles to users.

List your super agent chat sessions. Optionally filter by title search term.

List all teams in your organization with their structure and sub-teams.

Assign or remove a role for a user. Set action to 'set' to assign or 'remove' to remove. Use list_roles to find available roles. Requires admin access.

Starts a conversation's CRM integration workflows asynchronously. Returns one {workflow_id, run_id} per started workflow — call get_integration_workflow_status for each to learn whether it completed, failed with a CRM validation error, or is still running. Use this when the user asks you to write Attention's extracted fields back to their CRM or to retry a previously failed push. Optional workflow_ids (max 25) scopes the run to specific integrations; field_keys scopes it to specific intelligence fields. Requires mcp:write and an org context. The conversation must belong to the caller's org (matches the widget's confirmCRM mutation access model).

Reactivate a previously deactivated user. Restores their access and team memberships. Requires admin access.

Remove a user from a team. Use get_team_members to find user IDs for a team. Requires admin access.

Update the title of a super agent session.

Search recorded calls by date, rep, team, keyword, opportunity, CRM fields, or transcript content. Returns a list of matching calls with titles, dates, participants, and scores within the authenticated user scope. Use transcript_search to find calls where specific words or phrases were spoken (e.g., "find calls discussing pricing"). When the match falls inside the transcript body, the result includes speaker-level snippets; otherwise only call metadata is returned. The title and CRM-account-name filters cover different surfaces, so a company-name query that may live on either one is best served by running both — once with the title filter, once with crm_field_entity_code="account", crm_field_field_name="Name", crm_field_values=["company name"] — then merging and deduplicating the results by ID. Note: transcript_search cannot be combined with crm_field_*, opportunity_id, participant_email, rep_email, rep_id, or title filters. Use transcript_search OR those filters, not both. If you need both, run two separate searches and cross-reference the IDs. transcript_search CAN be combined with from_date, to_date, team_id, and hide_* filters.

Autonomous agent with access to search, CRM data and other integrations. Best for complex or open-ended questions that go beyond analyzing specific calls. Creates a new session if no session_id is provided. Waits up to 15 seconds for a synchronous response. If the response is not ready, it returns status 'processing' and a session_id — poll with get_super_agent_session_history every 15-20 seconds until the assistant message appears. Super-agent responses are final synthesized output — treat them as authoritative rather than raw data to re-summarize.

Force-sync CRM entity and field definitions from the CRM platform. Useful after CRM schema changes. Requires admin access.

Dry-run one numeric scorecard item prompt against one conversation using the same playground pipeline as the Attention testing window. Supply scorecard_id and item_id to test deployed values, optionally overriding draft prompt fields; or supply a complete draft title and numeric_scorecard_metadata. Returns score, explanation, and timestamped evidence without writing scorecard results. Requires mcp:write and an organization context.

Update an existing CRM integration's name, fields, or enabled status. The name should reflect the CRM entity type (e.g. 'Deal Sync' for Opportunity entities). Use get_crm_integrations to see existing integrations and their entity types. Requires admin access.

Update an existing forecast category. Requires admin access. System-managed categories only allow description and include_in_call updates.

Update a CRM prompt collection's name, team assignments, or criteria filters. Requires admin access.

Update a CRM prompt/field's title, prompt, response type, or options. Requires admin access.

Update a pending invitation's seat type. Only pending (not yet accepted) invitations can be updated. Requires admin access and user-level authentication.

Update an existing label category, including its classification options. Requires admin access. Use list_labels to find label IDs and see current options.

Update organization settings: call joining configuration and bot image enforcement. Requires admin access.

Update an existing scorecard's settings, criteria filters, or AI prompt. Requires admin access. Use get_scorecard_details to see current values. Use create_scorecard_item / update_scorecard_item / delete_scorecard_item to manage scoring items.

Update a scoring criterion on a scorecard. Use get_scorecard_details to find item IDs. Requires admin access.

Move a scorecard item to a new position within its scorecard. Use get_scorecard_details to see current item positions. Requires admin access.

Set the score ranges (min, middle, max) for all items in a scorecard. Use get_scorecard_details to see current ranges. Requires admin access.

Update a team's name or parent team. Use list_teams to find team IDs. Requires admin access.

Update a user's profile, role, or seat type. Use list_reps to find user IDs and list_roles for role IDs. Requires admin access.

Add or remove a user from teams in a single operation. Can set the primary team. Use list_reps, list_teams, and get_team_members to find IDs. Requires admin access.