agent_suspend
Suspend an MCP-managed agent at a task boundary to release runtime resources while retaining its native session ID. Distinct from stopping, which discards the agent.
Instructions
Suspend an idle or finished MCP-managed logical agent by closing its dedicated Herdr workspace while retaining a uniquely attributed native harness session ID. Use at a task/turn boundary to release runtime resources; legacy agents and sessions without verified native attribution fail clearly. This is distinct from agent_stop, which discards the logical agent.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agentId": "<agentId>"
},
"name": "agent_suspend"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | Yes | MCP-managed persistent agent ID returned by agent_start. |