MCP documentation | MCP docs for agents
ark_list_agent_sessions
ark.list_agent_sessions
List MCP and hosted-agent sessions for the connected user with status, budget counters, and client metadata.
- Availability
- Expanded preview
- Scopes
agents:read- ARK permissions
- None
- Team visibility
- Not entity-scoped
- Approval policy
none- ARK approval request
- Not required
- Idempotency
- Not required
- Read-only
- Yes
- Destructive
- No
- External side effect
- No
- Rate limit
- OAuth MCP credential and organization budgets
Input
statusstringOptional exact session status filter.
one of: active, completed, stopped, expired, failed
includeInactivebooleanInclude non-active sessions when status is omitted.
default: false
limitintegerdefault: 50; min: 1; max: 100
Result
The tool returns the canonical ark.list_agent_sessions operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.