> ## 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`](/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.
</Warning>

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

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

<ParamField query="content" type="string" required>
  The message content to send to the super agent.
</ParamField>

<ParamField query="session_id" type="string">
  Existing session ID. If omitted, a new session is created automatically.
</ParamField>

<ParamField query="timezone" type="string">
  Optional timezone for context-aware responses (e.g. `America/New_York`).
</ParamField>

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

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

<ParamField query="search" type="string">
  Optional search term to filter sessions by title.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of sessions to return. Default: `50`. Maximum: `1000`.
</ParamField>

***

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

<Note>Scope: `mcp:read`. Requires user-level authentication.</Note>

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

<ParamField query="session_id" type="string" required>
  The session ID to retrieve message history for.
</ParamField>

***

### cancel\_super\_agent\_processing

<Warning>Scope: `mcp:write`. Requires user-level authentication.</Warning>

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

<ParamField query="session_id" type="string" required>
  The session ID to cancel processing for.
</ParamField>

<ParamField query="reason" type="string">
  Optional reason for cancellation.
</ParamField>

***

### rename\_super\_agent\_session

<Warning>Scope: `mcp:write`. Requires user-level authentication.</Warning>

Update the title of a super agent session.

<ParamField query="session_id" type="string" required>
  The session ID to rename.
</ParamField>

<ParamField query="title" type="string" required>
  The new title for the session.
</ParamField>

***

### delete\_super\_agent\_session

<Warning>Scope: `mcp:write`. Requires user-level authentication. Destructive.</Warning>

Delete a super agent session and all its messages.

<ParamField query="session_id" type="string" required>
  The session ID to delete.
</ParamField>