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

# Super Agent

> Chat with the autonomous Attention super agent — best for complex, open-ended questions that span search, CRM, and integrations.

The super agent is an autonomous Attention agent with broad access to search, CRM data, and other integrations. Unlike [`ask_attention`](https://docs.attention.com/mcp/tools/ai-analysis#ask_attention) — which runs a focused analysis over a fixed list of calls — the super agent decides for itself which sources to query, runs as long as it needs, and may take multiple steps to reach an answer.

All super agent tools require **user-level authentication** (org-level API keys are not supported), since sessions are tied to a specific user.

> [!WARNING]
>
> When relaying super agent output, **always present the agent's responses to the user exactly as returned** — do not summarize, reinterpret, or rephrase them. The agent's wording, citations, and structure are intentional.

## Async response model

`send_super_agent_message` waits up to **15 seconds** for a synchronous response. If the agent is still working when the timeout hits, the tool returns `status: "processing"` along with a `session_id`. To get the final answer:

1. Poll [`get_super_agent_session_history`](#get_super_agent_session_history) every 15–20 seconds.
2. Inspect the last message — if its `role` is `assistant`, the response is ready.
3. If the user wants to stop early, call [`cancel_super_agent_processing`](#cancel_super_agent_processing).

## Tools

### send\_super\_agent\_message

> [!WARNING]
>
> Scope: `mcp:write`. Requires user-level authentication.

Send a message to the super agent. Creates a new session if no `session_id` is provided.

**content** `string` *required*

The message content to send to the super agent.

**session\_id** `string`

Existing session ID. If omitted, a new session is created automatically.

**timezone** `string`

Optional timezone for context-aware responses (e.g. `America/New_York`).

**Returns:** Either the agent's response (synchronous case) or a `processing` status with the `session_id` (async case).

***

### list\_super\_agent\_sessions

> [!NOTE]
>
> Scope: `mcp:read`. Requires user-level authentication.

List your super agent chat sessions. Useful for resuming a prior conversation.

**search** `string`

Optional search term to filter sessions by title.

**limit** `integer`

Maximum number of sessions to return. Default: `50`. Maximum: `1000`.

***

### get\_super\_agent\_session\_history

> [!NOTE]
>
> Scope: `mcp:read`. Requires user-level authentication.

Get the message history for a 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 `processing`.

**session\_id** `string` *required*

The session ID to retrieve message history for.

***

### cancel\_super\_agent\_processing

> [!WARNING]
>
> Scope: `mcp:write`. Requires user-level authentication.

Cancel in-progress super agent processing for a session. Use this when the user wants to stop a long-running query.

**session\_id** `string` *required*

The session ID to cancel processing for.

**reason** `string`

Optional reason for cancellation.

***

### rename\_super\_agent\_session

> [!WARNING]
>
> Scope: `mcp:write`. Requires user-level authentication.

Update the title of a super agent session.

**session\_id** `string` *required*

The session ID to rename.

**title** `string` *required*

The new title for the session.

***

### delete\_super\_agent\_session

> [!WARNING]
>
> Scope: `mcp:write`. Requires user-level authentication. Destructive.

Delete a super agent session and all its messages.

**session\_id** `string` *required*

The session ID to delete.


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