Cloud MCPagents
agents
23 MCP tools on the Hanzo cloud door that call the agents API.
The 23 tools tools/list names for agents. Each dispatches to an operation in the agents API reference.
| Tool | Route | Arguments | Description |
|---|---|---|---|
delete_v1_agents_ref | DELETE /v1/agents/{ref} | 1 | DeleteAgent removes an agent and every run recorded against it. |
delete_v1_agents_targets_id | DELETE /v1/agents/targets/{id} | 1 | DeleteTarget deregisters one machine. Only its owner, or an org admin, may remove it; an unknown id, |
get_v1_agents | GET /v1/agents | 0 | ListAgents returns every agent defined in the caller's org, each with the number of runs recorded ag |
get_v1_agents_activity | GET /v1/agents/activity | 0 | AgentActivity serves the org-wide recent-activity feed. |
get_v1_agents_builds | GET /v1/agents/builds | 1 | ListBuilds returns the public index of every published build, most recently updated first, so a gall |
get_v1_agents_builds_org_project | GET /v1/agents/builds/{org}/{project} | 2 | ReadBuild returns the readable build of one product: the agent session that produced it, turn by tur |
get_v1_agents_metrics | GET /v1/agents/metrics | 1 | AgentMetrics serves the invocations-over-time histogram for the org's Agents dashboard. |
get_v1_agents_ref | GET /v1/agents/{ref} | 1 | GetAgent returns one agent with its system prompt and its 20 most recent runs. |
get_v1_agents_ref_runs | GET /v1/agents/{ref}/runs | 2 | ListAgentRuns returns one agent's execution history, newest first — each run's input, its output or |
get_v1_agents_sessions | GET /v1/agents/sessions | 5 | ListSessions returns the caller org's live sessions, newest first — each with its event count, its d |
get_v1_agents_sessions_id | GET /v1/agents/sessions/{id} | 1 | GetSession returns one session with its direct child sessions and its 50 most recent events, oldest |
get_v1_agents_sessions_id_control | GET /v1/agents/sessions/{id}/control | 2 | DrainSessionControl returns the steering commands (pause/resume/stop/message) recorded against the c |
get_v1_agents_sessions_id_tree | GET /v1/agents/sessions/{id}/tree | 1 | SessionTree returns the subagent-flow graph rooted at this session: the session, its children, their |
get_v1_agents_targets | GET /v1/agents/targets | 0 | ListTargets returns every machine registered to the caller's org, newest first, each with its live s |
get_v1_agents_targets_id | GET /v1/agents/targets/{id} | 1 | GetTarget returns one registered machine, with its live session load. |
patch_v1_agents_ref | PATCH /v1/agents/{ref} | 9 | UpdateAgent changes an agent in place. Every field is optional; a field the request omits keeps its |
patch_v1_agents_sessions_id | PATCH /v1/agents/sessions/{id} | 7 | PatchSession updates a session's surface-owned truth: its status, its title, the run-target it is di |
patch_v1_agents_targets_id | PATCH /v1/agents/targets/{id} | 8 | PatchTarget updates one machine in place. Every field is optional; a field the request omits is left |
post_v1_agents | POST /v1/agents | 9 | CreateAgent defines an agent in the caller's org: a model, a system prompt (instructions) and a set |
post_v1_agents_sessions | POST /v1/agents/sessions | 16 | RegisterSession opens a live agent session in the caller's org — the row every surface (the CLI's ou |
post_v1_agents_targets | POST /v1/agents/targets | 7 | RegisterTarget registers a machine as an agent target, or re-links one that is already registered. |
post_v1_agents_targets_id_claim | POST /v1/agents/targets/{id}/claim | 1 | ClaimRoutedRun is the machine's long poll for work: it authenticates the daemon, stamps the liveness |
post_v1_agents_targets_id_runs_runId_report | POST /v1/agents/targets/{id}/runs/{runId}/report | 8 | ReportRoutedRun completes a claimed run: it delivers the terminal result to the run's durable owner, |
Generated from tools/list on https://api.hanzo.ai/v1/mcp — 834 tools captured 2026-08-01 (this build read the vendored copy; the door was unreachable).
How is this guide?