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

# Intelligence

> Manage intelligence collections (CRM prompt sets) and their items (individual extraction prompts).

Intelligence in Attention refers to AI-extracted CRM fields — Champion, Next Steps, Competitor, Budget, etc. The data model has two levels:

1. **Collections** group related prompts and apply them to calls matching a label-based criteria filter.
2. **Items** are the individual prompts inside a collection, each describing one field to extract from a call.

Use [`list_intelligence_collections`](#list_intelligence_collections) to see what's configured, then drill into one with [`list_intelligence_items`](#list_intelligence_items). All write tools require admin access.

## Collection tools

### list\_intelligence\_collections

<Note>Scope: `mcp:read`. No parameters.</Note>

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

**Returns:** Markdown list of collections with name, ID, team scope, and criteria operators / conditions.

***

### create\_intelligence\_collection

<Warning>Scope: `mcp:write`. Requires admin role.</Warning>

Create a new CRM prompt collection. Collections group CRM extraction prompts and apply them to calls matching label-based criteria.

<ParamField query="name" type="string" required>
  Name of the collection (must be unique within the org).
</ParamField>

<ParamField query="all_teams" type="boolean">
  Apply to all teams.
</ParamField>

<ParamField query="team_ids" type="array">
  Team IDs this collection applies to. Ignored if `all_teams` is `true`.
</ParamField>

<ParamField query="criteria" type="object">
  Label-based filter: calls matching these criteria use this collection's CRM prompts.

  * `operator`: `AND` or `OR`.
  * `conditions`: array of `{ "field": "Call Type", "value": "Discovery" }`.
</ParamField>

***

### update\_intelligence\_collection

<Warning>Scope: `mcp:write`. Requires admin role.</Warning>

Update a collection's name, team assignments, or criteria filters. Omitted fields preserve their current values.

<ParamField query="collection_id" type="string" required>
  The UUID of the collection to update.
</ParamField>

<ParamField query="name" type="string">
  New name.
</ParamField>

<ParamField query="all_teams" type="boolean">
  Apply to all teams.
</ParamField>

<ParamField query="team_ids" type="array">
  Team IDs this collection applies to.
</ParamField>

<ParamField query="criteria" type="object">
  New label-based filter conditions. Replaces existing criteria.
</ParamField>

***

### delete\_intelligence\_collection

<Warning>Scope: `mcp:write`. Requires admin role. Destructive.</Warning>

Delete a collection. This is permanent.

<ParamField query="collection_id" type="string" required>
  The UUID of the collection to delete.
</ParamField>

## Item tools

### list\_intelligence\_items

<Note>Scope: `mcp:read`.</Note>

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

<ParamField query="collection_id" type="string" required>
  UUID of the intelligence collection.
</ParamField>

**Returns:** Markdown list of intelligence items with title, ID, category, description, prompt (truncated to 200 chars), response type, options, and analysis level.

***

### create\_intelligence\_item

<Warning>Scope: `mcp:write`. Requires admin role.</Warning>

Add a CRM prompt/field to a collection. Each item defines an AI extraction prompt that runs on calls matching the collection's criteria.

<ParamField query="collection_id" type="string" required>
  UUID of the intelligence collection.
</ParamField>

<ParamField query="title" type="string" required>
  Field title (e.g. `Champion`, `Next Steps`, `Competitor`).
</ParamField>

<ParamField query="contents" type="string" required>
  The AI prompt that defines what to extract from calls.
</ParamField>

<ParamField query="category" type="string">
  Item category. Default: `CRM`.
</ParamField>

<ParamField query="content_type" type="string">
  Content type. Default: `text`.
</ParamField>

<ParamField query="prompt_type" type="string">
  Prompt type. Default: `base`.
</ParamField>

<ParamField query="response_type" type="string">
  Response type: `list` for multi-select. Omit for free-text responses.
</ParamField>

<ParamField query="options" type="array">
  For `list` response type: available options (e.g. `["Salesforce", "HubSpot"]`).
</ParamField>

<ParamField query="description" type="string">
  Description of this field.
</ParamField>

<ParamField query="allow_long_response" type="boolean">
  Allow longer AI responses.
</ParamField>

<ParamField query="extract_quotes" type="boolean">
  Include direct quotes from the call.
</ParamField>

<ParamField query="max_values" type="integer">
  Maximum number of values for list responses.
</ParamField>

<ParamField query="analysis_level" type="string">
  Analysis scope: `conversation` (per-call, default) or `deal` (across all calls in a deal).
</ParamField>

<ParamField query="display_order" type="integer">
  Position in the UI list. Lower numbers appear first.
</ParamField>

***

### update\_intelligence\_item

<Warning>Scope: `mcp:write`. Requires admin role.</Warning>

Update a CRM prompt/field's title, prompt, response type, or options. Omitted fields preserve current values.

<ParamField query="item_id" type="string" required>
  UUID of the intelligence item assignment.
</ParamField>

<ParamField query="title" type="string">
  Updated title.
</ParamField>

<ParamField query="contents" type="string">
  Updated AI prompt.
</ParamField>

<ParamField query="content_type" type="string">
  Content type.
</ParamField>

<ParamField query="prompt_type" type="string">
  Prompt type.
</ParamField>

<ParamField query="response_type" type="string">
  Response type: `list` for multi-select.
</ParamField>

<ParamField query="options" type="array">
  Available options for list responses.
</ParamField>

<ParamField query="description" type="string">
  Description.
</ParamField>

<ParamField query="allow_long_response" type="boolean">
  Allow longer AI responses.
</ParamField>

<ParamField query="extract_quotes" type="boolean">
  Include direct quotes.
</ParamField>

<ParamField query="max_values" type="integer">
  Max values for list responses.
</ParamField>

<ParamField query="analysis_level" type="string">
  Analysis scope: `conversation` or `deal`.
</ParamField>

<ParamField query="display_order" type="integer">
  Position in the UI list.
</ParamField>

***

### delete\_intelligence\_item

<Warning>Scope: `mcp:write`. Requires admin role. Destructive.</Warning>

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

<ParamField query="item_id" type="string" required>
  UUID of the intelligence item to delete.
</ParamField>