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.
​
string
required
The message content to send to the super agent.
​
string
Existing session ID. If omitted, a new session is created automatically.
​
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.
​
string
Optional search term to filter sessions by title.
​
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.
​
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.
​
string
required
The session ID to cancel processing for.
​
string
Optional reason for cancellation.

​
rename_super_agent_session

Scope: mcp:write. Requires user-level authentication.
Update the title of a super agent session.
​
string
required
The session ID to rename.
​
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.
​
string
required
The session ID to delete.