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

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.

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

**name** `string` *required*

Name of the collection (must be unique within the org).

**all\_teams** `boolean`

Apply to all teams.

**team\_ids** `array`

Team IDs this collection applies to. Ignored if `all_teams` is `true`.

**criteria** `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" }`.

***

### update\_intelligence\_collection

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

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

**collection\_id** `string` *required*

The UUID of the collection to update.

**name** `string`

New name.

**all\_teams** `boolean`

Apply to all teams.

**team\_ids** `array`

Team IDs this collection applies to.

**criteria** `object`

New label-based filter conditions. Replaces existing criteria.

***

### delete\_intelligence\_collection

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role. Destructive.

Delete a collection. This is permanent.

**collection\_id** `string` *required*

The UUID of the collection to delete.

## Item tools

### list\_intelligence\_items

> [!NOTE]
>
> Scope: `mcp:read`.

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

**collection\_id** `string` *required*

UUID of the intelligence collection.

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

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

**collection\_id** `string` *required*

UUID of the intelligence collection.

**title** `string` *required*

Field title (e.g. `Champion`, `Next Steps`, `Competitor`).

**contents** `string` *required*

The AI prompt that defines what to extract from calls.

**category** `string`

Item category. Default: `CRM`.

**content\_type** `string`

Content type. Default: `text`.

**prompt\_type** `string`

Prompt type. Default: `base`.

**response\_type** `string`

Response type: `list` for multi-select. Omit for free-text responses.

**options** `array`

For `list` response type: available options (e.g. `["Salesforce", "HubSpot"]`).

**description** `string`

Description of this field.

**allow\_long\_response** `boolean`

Allow longer AI responses.

**extract\_quotes** `boolean`

Include direct quotes from the call.

**max\_values** `integer`

Maximum number of values for list responses.

**analysis\_level** `string`

Analysis scope: `conversation` (per-call, default) or `deal` (across all calls in a deal).

**display\_order** `integer`

Position in the UI list. Lower numbers appear first.

***

### update\_intelligence\_item

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role.

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

**item\_id** `string` *required*

UUID of the intelligence item assignment.

**title** `string`

Updated title.

**contents** `string`

Updated AI prompt.

**content\_type** `string`

Content type.

**prompt\_type** `string`

Prompt type.

**response\_type** `string`

Response type: `list` for multi-select.

**options** `array`

Available options for list responses.

**description** `string`

Description.

**allow\_long\_response** `boolean`

Allow longer AI responses.

**extract\_quotes** `boolean`

Include direct quotes.

**max\_values** `integer`

Max values for list responses.

**analysis\_level** `string`

Analysis scope: `conversation` or `deal`.

**display\_order** `integer`

Position in the UI list.

***

### delete\_intelligence\_item

> [!WARNING]
>
> Scope: `mcp:write`. Requires admin role. Destructive.

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

**item\_id** `string` *required*

UUID of the intelligence item to delete.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.