Skip to main content
The super agent is an autonomous Attention agent with broad access to search, CRM data, and other integrations. Unlike 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.
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 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.

​
Tools

​
send_super_agent_message

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

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

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

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

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

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.