> ## 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.

# Attention MCP Server

> Connect Claude and other LLM clients to your Attention workspace. Search calls, analyze deals, configure scorecards, manage teams, and chat with the Attention super agent — all through natural language.

## Overview

The Attention MCP Server connects AI assistants — Claude, ChatGPT, IDE agents — directly to your organization's conversation intelligence data and workspace configuration. Attention captures, transcribes, and analyzes every sales and customer conversation, syncing structured insights to your CRM. Through the MCP server, an LLM can read those calls and act on your workspace exactly as a logged-in user would.

<CardGroup cols={2}>
  <Card icon="magnifying-glass" title="Search & Discovery">
    Find calls by date, rep, team, keyword, opportunity, CRM field, or transcript content across your entire org.
  </Card>

  <Card icon="sparkles" title="AI Analysis">
    Run natural-language analysis across up to 25 calls in a single request, or chat with the autonomous Attention super agent.
  </Card>

  <Card icon="chart-bar" title="Coaching & Scorecards">
    Review and configure scorecards, criteria, weights, ranges, and team assignments.
  </Card>

  <Card icon="sitemap" title="Workspace Administration">
    Manage teams, users, roles, invitations, labels, forecasting, CRM integrations, and intelligence collections.
  </Card>
</CardGroup>

## Quickstart

Get connected in under a minute from any MCP-compatible client.

<Steps>
  <Step title="Open your client's connector settings">
    In Claude.ai, go to **Settings → Connectors**. In Claude Desktop, **Settings → Connectors**. Other MCP-compatible clients have similar entry points.
  </Step>

  <Step title="Add the Attention connector">
    Search for **Attention** in the connector directory, or click **Add custom connector** and paste the server URL:

    ```
    https://api.attention.tech/mcp
    ```
  </Step>

  <Step title="Authenticate">
    Click **Connect** and complete the OAuth flow. The MCP server enforces the same permissions as your Attention account — if you can see a call in the app, the assistant can read it through the connector. Anything you cannot see is invisible to the assistant.
  </Step>

  <Step title="Ask away">
    Try: *"What were the main objections in our sales calls this week?"* or *"Create a Discovery scorecard with three criteria and assign it to the SMB team."*
  </Step>
</Steps>

<Note>
  **For Team & Enterprise plans:** an organization Owner must add the connector in Organization Settings → Connectors before individual users can connect.
</Note>

For the developer setup (HTTP endpoint, API keys, scopes, rate limits), see [Authentication](/mcp/authentication).

## What's available

The server exposes **68 tools** across 15 functional groups. Read tools require the `mcp:read` scope; write tools require `mcp:write` and many also require admin role.

| Group                                   | Tools  | Highlights                                      |
| --------------------------------------- | ------ | ----------------------------------------------- |
| [Identity](/mcp/tools/identity)         | 1      | `get_me`                                        |
| [Calls](/mcp/tools/calls)               | 2      | `search_calls`, `get_call_details`              |
| [AI Analysis](/mcp/tools/ai-analysis)   | 1      | `ask_attention`                                 |
| [Snippets](/mcp/tools/snippets)         | 1      | `create_snippet`                                |
| [Teams](/mcp/tools/teams)               | 9      | List, create, archive, manage members           |
| [Users & Roles](/mcp/tools/users-roles) | 11     | List reps, manage roles, invitations, lifecycle |
| [Organization](/mcp/tools/organization) | 2      | Org overview and settings                       |
| [Scorecards](/mcp/tools/scorecards)     | 9      | Templates, items, ranges, ordering              |
| [Labels](/mcp/tools/labels)             | 5      | Categories, options, conversation labels        |
| [Forecasting](/mcp/tools/forecasting)   | 3      | Categories and quotas                           |
| [CRM](/mcp/tools/crm)                   | 6      | Integrations, field sync, OAuth connections     |
| [Intelligence](/mcp/tools/intelligence) | 8      | CRM prompt collections and items                |
| [API Keys](/mcp/tools/api-keys)         | 3      | Programmatic access management                  |
| [Super Agent](/mcp/tools/super-agent)   | 6      | Autonomous chat sessions                        |
| [Reports](/mcp/tools/reports)           | 1      | Per-user activity and usage metrics             |
| **Total**                               | **68** |                                                 |

For a flat, searchable list of every tool with its scope and a one-line description, see the [Tools Reference](/mcp/tools-overview).

## Example prompts

A few of the things you can ask Claude (or any MCP-compatible LLM) once the connector is enabled. See [more examples](/mcp/examples).

<CardGroup cols={2}>
  <Card title="Search & analyze">
    *"What were the main objections prospects raised in calls with Datadog this quarter?"*
  </Card>

  <Card title="Coaching">
    *"Compare how our top reps handle pricing objections vs. the rest of the team this month."*
  </Card>

  <Card title="Scorecard configuration">
    *"Create a Discovery scorecard with three criteria — Pain Identification, Stakeholder Mapping, and Next Steps — on a 1–5 scale, applied to the AE team."*
  </Card>

  <Card title="Workspace admin">
    *"Invite [alex@example.com](mailto:alex@example.com) as a Sales Rep on the SMB team and add them to the Pricing Discovery intelligence collection."*
  </Card>
</CardGroup>

## Version history

The MCP server is versioned independently from the Attention API. Current version: **v1.7.0**. Each release is additive — no tool has been removed since v1.0.0.

<AccordionGroup>
  <Accordion title="v1.7.0 — current">
    Reports: `get_usage_report` returns per-user activity metrics (coaching sessions, calls viewed, comments left, snippets created, AI insights ran, Super Agent web/Slack queries) for a date range. Requires an org-level API key.
  </Accordion>

  <Accordion title="v1.6.0">
    User management (`manage_user_role`, `delete_user`, `reactivate_user`), conversation labels (`change_conversation_labels`), CRM write tools (`create_crm_integration`, `update_crm_integration`, `sync_crm_fields`, `delete_crm_account`), org settings (`update_org_settings`), scorecard configuration (`update_scorecard_item_order`, `update_scorecard_ranges`), and OAuth connection tooling (`connect_integration` for Salesforce, HubSpot, Microsoft).
  </Accordion>

  <Accordion title="v1.5.0">
    Team write tools (`create_team`, `update_team`, `archive_team`, `add_team_member`, `remove_team_member`, `change_team_parent`), user write tools (`update_user`, `update_user_teams`), intelligence collections and items (8 tools), and API key management (`list_api_keys`, `create_api_key`, `delete_api_key`).
  </Accordion>

  <Accordion title="v1.4.0">
    Transcript search via Algolia. Adds the `transcript_search` parameter to `search_calls` for full-text matching inside call transcripts.
  </Accordion>

  <Accordion title="v1.3.0">
    Invitation tools: `invite_user`, `update_invitation`, `delete_invitation`, `list_invitations`.
  </Accordion>

  <Accordion title="v1.2.0">
    Org configuration tools — labels (`list_labels`, `create_label`, `update_label`, `delete_label`), scorecard write (`create_scorecard`, `update_scorecard`, scorecard item CRUD), forecast (`get_forecast_config`, `create_forecast_category`, `update_forecast_category`), and CRM read (`get_crm_integrations`).
  </Accordion>

  <Accordion title="v1.1.0">
    Super agent tools: `send_super_agent_message`, `list_super_agent_sessions`, `get_super_agent_session_history`, `delete_super_agent_session` (and later `cancel_super_agent_processing` and `rename_super_agent_session`).
  </Accordion>

  <Accordion title="v1.0.0">
    Initial release: identity (`get_me`), calls (`search_calls`, `get_call_details`), AI analysis (`ask_attention`), snippets (`create_snippet`), teams (`list_teams`, `get_team`, `get_team_members`), users (`list_reps`), roles (`list_roles`), scorecards read (`get_scorecards`, `get_scorecard_details`), and org overview (`get_org_overview`).
  </Accordion>
</AccordionGroup>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Which Claude plans support this connector?">
    The Attention connector is available on Claude Pro, Max, Team, and Enterprise plans. The MCP server itself is open to any MCP-compatible client.
  </Accordion>

  <Accordion title="Can I use this with Claude Desktop or Claude Code?">
    Yes. Add the connector via **Settings → Connectors** in Claude Desktop. Remote MCP servers added in claude.ai are also automatically available in Claude Code.
  </Accordion>

  <Accordion title="How current is the call data?">
    The MCP server queries the Attention API in real time. Calls appear as soon as they are processed — typically within minutes of the call ending.
  </Accordion>

  <Accordion title="Can the MCP server see calls I don't have access to?">
    No. Every tool runs under your authenticated identity. Attention's permission model is enforced server-side; if your account cannot see a call, scorecard, team, or user in the app, the MCP server will not return it.
  </Accordion>

  <Accordion title="Are there destructive operations?">
    Yes. Tools like `delete_user`, `archive_team`, `delete_label`, `delete_scorecard_item`, `delete_intelligence_collection`, `delete_intelligence_item`, `delete_api_key`, `delete_crm_account`, and `delete_super_agent_session` mutate or remove data. They require admin access and the `mcp:write` scope, and Claude will surface them with a destructive warning before invoking. Each destructive tool is flagged on its reference page.
  </Accordion>

  <Accordion title="How do I revoke access?">
    Go to **Settings → Connectors** in Claude.ai (or your client of choice) and click **Disconnect** on the Attention connector. For API keys created via `create_api_key`, use `delete_api_key` or revoke from **Settings → API Keys** in the Attention app.
  </Accordion>
</AccordionGroup>