Attention.com MCP Server

MCP server that connects Claude to the Attention.com conversation intelligence platform. Access sales call transcripts, AI-powered analysis, and insights directly from Claude.

Prerequisites

• Node.js 18+ — check with node --version (download if needed)
• Git access to this private repo
• Attention.com API key — generate at Settings > Organization > API Keys in app.attention.tech

Install

git clone git@github.com:simonstephens/attention-mcp.git
cd attention-mcp
npm install
npm run build

Configuration

Each person needs to configure their Claude client to run this MCP server with their own ATTENTION_API_KEY. Choose the section that matches your client.

Claude Code (CLI)

claude mcp add --transport stdio \
  --env ATTENTION_API_KEY=your-api-key-here \
  attention -- node /absolute/path/to/attention-mcp/dist/index.js

Replace /absolute/path/to/attention-mcp with the actual path where you cloned the repo.

Claude Desktop

1. Open Claude Desktop > Settings > Developer > Edit Config
2. Add the attention block inside mcpServers (create the key if it doesn't exist):

{
  "mcpServers": {
    "attention": {
      "command": "node",
      "args": ["/absolute/path/to/attention-mcp/dist/index.js"],
      "env": {
        "ATTENTION_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Replace /absolute/path/to/attention-mcp with the actual path where you cloned the repo.
4. Quit and relaunch Claude Desktop.

Cowork Desktop

Follow the same JSON configuration format as Claude Desktop above. Add the attention server entry to your Cowork MCP settings with the same command, args, and env fields.

Available Tools

list_conversations

List conversations with optional filters (date range, owner, participant, team, title). Returns paginated summaries.

get_conversation

Get a single conversation by UUID with full transcript, participants, scorecard results, and extracted intelligence.

search_conversations

Full-text search across recent conversation transcripts. Fetches up to 5 pages and searches client-side (the Attention API doesn't support server-side transcript search).

ask_attention

Send a natural language prompt to Attention AI for analysis of one or more conversations. Useful for extracting themes, action items, objections, and sentiment.

get_insights

Retrieve historical Generalized Intelligence (GI) insights. Requires a user UUID — use list_api_keys to find yours.

update_conversation

Update a conversation's title or labels.

list_api_keys

List API keys for the account. Useful for discovering your user UUID.

Updating

When there's a new version, pull and rebuild:

cd /path/to/attention-mcp
git pull
npm install
npm run build

Then restart your Claude client to pick up the changes.

Development

npm run build    # Compile TypeScript
npm run dev      # Run directly with tsx (no build needed)

Debug Logging

Set ATTENTION_DEBUG=1 to log all API requests to stderr:

ATTENTION_DEBUG=1 ATTENTION_API_KEY=... npm run dev

Troubleshooting

• "ATTENTION_API_KEY environment variable is required" — Set the env var in your Claude client config (see Configuration above)
• "Invalid or expired API key" — Regenerate your key at app.attention.tech
• "Rate limited" — The Attention API has rate limits; wait a moment and retry
• search_conversations is slow — It fetches multiple pages of transcripts; reduce maxPages or narrow the date range
• MCP server not appearing in Claude — Make sure you've restarted your Claude client after updating the config