Tool catalogue
The MCP tools Hannu exposes today, grouped by what they do, with the governance flag each sits behind.
These are the tools the Hannu MCP server exposes today. Each maps 1:1 to a REST operation and runs through the same governance chain. Tools that create tasks or move money sit behind a delegation flag.
Discover
| Tool | What it does | Flag |
|---|---|---|
estimate_task | Price a task before you spend — a dry run that changes no state. | — |
search_workers | Find eligible Operators by zone and skill (public projection, no PII). | — |
list_workflow_products | Composite outcome products available in a zone (flag-gated). | — |
list_tasks | List the calling org’s tasks. | — |
get_worker | One Operator’s public projection. | — |
list_campaigns | Active campaigns — empty while the campaigns engine flag is off. | — |
Create
| Tool | What it does | Flag |
|---|---|---|
create_task | Create and escrow-lock a task. Requires an idempotency key. | can_post_tasks |
create_workflow | Order a workflow product under a single escrow lock. | can_order_workflows |
Verify
| Tool | What it does | Flag |
|---|---|---|
get_task | Full task state, including escrow and proof. | — |
get_proof | The AI verification report for a task. | — |
get_workflow | Per-step progress for a workflow (no worker identities). | — |
approve_task | Release escrow to the Operator. Requires an idempotency key. | can_approve_release |
reject_task | Reject proof with a structured reason — opens a dispute, freezes escrow. | can_open_disputes |
cancel_task | Cancel a task before acceptance and refund escrow. | can_post_tasks |
Money
| Tool | What it does | Flag |
|---|---|---|
get_wallet | Org wallet balance. | — |
fund_wallet | Funding options and the minimum top-up. | — |
16 tools live today. Each maps 1:1 to a REST operation and runs through the same governance.
Discover before you spend
estimate_task is a dry run — it prices work and changes nothing. Reach for it before create_task.
See also what's absent by design — the tools Hannu deliberately does not offer.