Hanzo
OpenapiTools

Lists every tool the caller's org and project can reach, from every source,…

Lists every tool the caller's org and project can reach, from every source, each flagged with whether it is activated.

GET /v1/tools

Addresshttps://api.hanzo.ai/v1/tools
MethodGET
Operationget_tools
AuthAuthorization: Bearer $HANZO_API_KEY

Lists every tool the caller's org and project can reach, from every source, each flagged with whether it is activated. This is the discovery surface: one flat set of names spanning connector actions, user functions, zap-service routes, agents, skills and the org's own external MCP servers, deduplicated by name so the highest-precedence source wins a collision. It lists; it does not call — dispatch is POST /v1/tools/call.

Request

2 fields.

FieldInTypeRequiredDescription
sourcequerystringSource keeps only tools from one source — connector, function, zap-service, agent, skill or mcp.
activatedquerystringActivated keeps only the tools activated for the caller's org and project, and only when it is exactly the string "true".

Response

StatusBodyMeaning
200toolListok

200 body — 11 fields.

FieldInTypeAlwaysDescription
toolsbodyTool[]Tools is every tool the caller may see, deduplicated by name with source precedence applied.
tools[].activatedbodybooleanActivated is filled by the registry from the activation store for the requesting (org,project); providers leave it zero.
tools[].descriptionbodystringDescription is the prose a model reads to decide whether to call the tool.
tools[].dispatchablebodybooleanDispatchable is whether the tool can be CALLED.
tools[].inputSchemabodyanySchema is the JSON Schema of the call arguments — the MCP inputSchema.
tools[].namebodystringName is the tool's id in the flat, fleet-wide tool namespace — the value a tools/call passes.
tools[].pricebodyPrice
tools[].price.amountbodyanyAmount is what ONE call costs, EXACTLY: an 18-decimal USD value, so a per-call price of 0.0025is0.0025 is 0.0025 and not a cent-floored zero.
tools[].price.currencybodystringCurrency is the ISO 4217 code, e.g.
tools[].price.recipientbodystringRecipient is the payout wallet ref the marketplace seller is paid at.
tools[].sourcebodystringSource is where the tool comes from: connector, function, zap-service, agent, skill or mcp.

Failure carries the platform error shape — see Errors.

Examples

hanzo tools get

Tools API · All Hanzo APIs · Interactive reference

How is this guide?

On this page