MCP documentation | MCP docs for agents
ark_stop_agent_session
ark.stop_agent_session
Stop an active MCP or hosted-agent session for the connected user.
- Availability
- Expanded preview
- Scopes
agents:write- ARK permissions
- None
- Team visibility
- Not entity-scoped
- Approval policy
draft_only- ARK approval request
- Not required
- Idempotency
- Required for external execution
- Read-only
- No
- Destructive
- No
- External side effect
- No
- Rate limit
- OAuth MCP credential and organization budgets
Input
sessionIdstringrequiredActive agent session ID to stop.
format: uuid
reasonstringOptional reason recorded in session metadata.
min length: 1; max length: 1000
Result
The tool returns the canonical ark.stop_agent_session 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.