Agents

Also for this capability: API · CLI · MCP · SDKs

agents: 36 operations. Name one in "op" and pass that operation's own arguments in "input". describe returns an operation's input schema.

Arguments

op — what each one does:

• list_agent_conversations — Returns a summary of every agent conversation in the caller's org — id, derived title, and when it was last appended…
• get_agent_conversation — Returns every message of one conversation in order — role, content, the assistant's tool calls where it made any, and…
• list_agent_presets — Returns the preset catalog: each entry's id, its description and whether it is server-executing — the flag that…
• post_agent — Answers one turn of a conversation with four things: the model's reply, the actions the server executed on the…
• delete_agent — Removes an agent and every run recorded against it.
• delete_agent_target — Deregisters one machine.
• list_agents — Returns every agent defined in the caller's org, each with the number of runs recorded against it.
• get_agent_activity — Serves the org-wide recent-activity feed.
• list_agent_builds — Returns the public index of every published build, most recently updated first, so a gallery can link straight to the…
• get_agent_build — Returns the readable build of one product: the agent session that produced it, turn by turn — the prompts, the…
• get_agent — Returns one agent with its system prompt and its 20 most recent runs.
• get_agents_by_ref_runs — Returns one agent's execution history, newest first — each run's input, its output or its error, and how long it took.
• list_agent_metrics — Serves the invocations-over-time histogram for the org's Agents dashboard.
• get_agents_runs — Returns the org's agent runs across EVERY agent, newest first — what ran here, for whom, on which model, how long it…
• list_agent_sessions — Returns the caller org's live sessions, newest first — each with its event count, its direct-child count and a…
• get_agent_session — Returns one session with its direct child sessions and its 50 most recent events, oldest of those first.
• get_agent_session_control — Returns the steering commands (pause/resume/stop/message) recorded against the caller's own session that are newer than…
• get_agent_session_tree — Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying…
• get_agent_session_stream — Holds the connection open as text/event-stream and pushes a frame each time the org's registry moves: an `event…
• list_agent_targets — Returns every machine registered to the caller's org, newest first, each with its live session load.
• get_agent_target — Returns one registered machine, with its live session load.
• update_agent — Changes an agent in place.
• update_agent_session — Updates a session's surface-owned truth: its status, its title, the run-target it is dispatched to, and the product it…
• update_agent_target — Updates one machine in place.
• post_agents — Defines an agent in the caller's org: a model, a system prompt (instructions) and a set of tool names.
• run_agent — Composes the agent's stored instructions with the caller's input, executes one real chat completion through the same…
• create_agent_session — Opens a live agent session in the caller's org — the row every surface (the CLI's outer agent, hanzo.bot, the…
• create_agent_session_event — Records a message, tool-call, spawn, log, status or control turn against the session and answers 201 with the stored…
• message_agent_session — Records message as a durable control event carrying the caller's text and answers 200 with {command, event…
• pause_agent_session — Records pause as a durable control event on the session and answers 200 with {command, event, forwarded} — the…
• resume_agent_session — Records resume as a durable control event on the session and answers 200 with {command, event, forwarded}.
• stop_agent_session — Records stop as a durable control event on the session and answers 200 with {command, event, forwarded}.
• create_agent_target — Registers a machine as an agent target, or re-links one that is already registered.
• claim_agent_target — ClaimRoutedRun is the machine's long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate…
• report_agent_target_run — Completes a claimed run: it delivers the terminal result to the run's durable owner, which is what lets that workflow…
• create_coding — Runs a coding task on a repository: clones it into a sandbox, lets a model read and edit the code, run the tests, and…

tools/list declares a type, a description, which fields are required and an enumerated value set for each field and nothing further, and every column above is MCP's own. This tool takes an operation name and that operation's arguments, so what the document constrains is what goes inside input, field by field, on the operation you name — ask describe for that. A — means MCP does not constrain the field.

Call it

A tools/call carries every argument in one flat object — nothing binds to a path or a query string. This call carries exactly the arguments the operation requires, so it is the smallest one that can run.

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "agents",
         "arguments": {
           "op": "list_agent_conversations"
         }
       }
     }'

Values are the operation's own defaults and enumerated values where it declares them, and a <placeholder> where neither source declares one. tools/list needs no credential; tools/call does — called without one MCP answers HTTP 200 with a JSON-RPC result whose isError is set and whose text says what was missing. How to get a key →

The operation behind it

agents dispatches to 36 operations. 3 of them MCP names exactly as the document ids them, and those are below; for the rest MCP has its own verb, which describe resolves.

The same capability over plain HTTP is in the agents API reference, on https://api.hanzo.ai.

All 121 tools · MCP · API reference

Generated from tools/list on https://api.hanzo.ai/v1/mcp — 121 tools captured 2026-08-16.