# Hannu Developer Docs

> Build the trusted human layer into your agent. Hannu lets AI agents hire KYC-verified Nigerian Operators for real-world tasks over MCP or REST, with escrow before work and a signed Verified report on every task.

Every page is available as clean Markdown by appending `.md` to its URL.

## Overview
- [Hannu developer docs](https://docs.hannu.africa/): What Hannu is and how to send your first task into the real world.

## Get started
- [Quickstart with MCP](https://docs.hannu.africa/get-started/quickstart-mcp): Connect over MCP and run your first verified task.
- [Quickstart with REST](https://docs.hannu.africa/get-started/quickstart-rest): Run your first verified task with plain HTTPS and curl.
- [Authentication](https://docs.hannu.africa/get-started/authentication): API keys, bearer auth, and the governance chain.

## Core concepts
- [How Hannu works](https://docs.hannu.africa/core-concepts/how-hannu-works): The end-to-end model behind every task.
- [Idempotency](https://docs.hannu.africa/core-concepts/idempotency): How to make writes safe to retry.
- [Errors](https://docs.hannu.africa/core-concepts/errors): The problem+json error shape and how to handle it.
- [Escrow and the ledger](https://docs.hannu.africa/core-concepts/escrow-and-ledger): Escrow states and the append-only ledger.
- [Pagination](https://docs.hannu.africa/core-concepts/pagination): How list responses are bounded today.
- [Rate limits](https://docs.hannu.africa/core-concepts/rate-limits): Per-agent limits, 429, and back-off.
- [Versioning and stability](https://docs.hannu.africa/core-concepts/versioning): URL versioning and what counts as the contract.
- [Governance](https://docs.hannu.africa/core-concepts/governance): Delegation, spend caps, kill switch, safety filter.
- [Proof and verification](https://docs.hannu.africa/core-concepts/proof-and-verification): Proof, the verification checks, and the Verified report.

## Guides
- [Create and fund a task](https://docs.hannu.africa/guides/create-and-fund-a-task): Fund a wallet and create your first real task.
- [Estimate before you spend](https://docs.hannu.africa/guides/estimate-before-you-spend): Price the work before you commit money.
- [Handle proof](https://docs.hannu.africa/guides/handle-proof): Approve, reject, or cancel a task once proof is in.
- [Order a workflow](https://docs.hannu.africa/guides/order-a-workflow): Order a multi-step workflow product end to end.
- [Verify a Pass](https://docs.hannu.africa/guides/verify-a-pass): Confirm an Operator's visit is authorised at the point of the visit.

## API reference
- [API reference](https://docs.hannu.africa/api-reference): The public REST surface and its conventions.
- [Tasks](https://docs.hannu.africa/api-reference/tasks): The tasks endpoints, request and response shapes.
- [Errors reference](https://docs.hannu.africa/api-reference/errors-reference): The complete error-code catalogue.
- [Discovery](https://docs.hannu.africa/api-reference/discovery): The public, no-key discovery endpoints.
- [Workers](https://docs.hannu.africa/api-reference/workers): Search and read Operators, public projection only.
- [Wallet](https://docs.hannu.africa/api-reference/wallet): Identity, balance, and funding endpoints.
- [Workflows](https://docs.hannu.africa/api-reference/workflows): Composite outcome products and their reports.
- [Pass](https://docs.hannu.africa/api-reference/pass): Verify a delegated one-time visit credential.

## MCP integration
- [Connect the MCP server](https://docs.hannu.africa/mcp/connect): Wire the hannu MCP server into your agent.
- [Tool catalogue](https://docs.hannu.africa/mcp/tools): Every live MCP tool and its governance flag.
- [Absent by design](https://docs.hannu.africa/mcp/absent-by-design): What Hannu refuses to do, and why.
- [MCP vs REST](https://docs.hannu.africa/mcp/mcp-vs-rest): Two front doors, one governed platform.

## Webhooks
- [Webhooks overview](https://docs.hannu.africa/webhooks/overview): How Hannu delivers events to your systems.
- [Verify webhook signatures](https://docs.hannu.africa/webhooks/signatures): Authenticate every delivery before you trust it.
- [Event catalogue](https://docs.hannu.africa/webhooks/events): The events that fire, grouped by resource.
- [Manage subscriptions](https://docs.hannu.africa/webhooks/subscriptions): Create endpoints and rotate secrets in the dashboard.

## Task types
- [The task-type catalogue](https://docs.hannu.africa/task-types/catalogue): Every task type, by family.
- [Capability states](https://docs.hannu.africa/task-types/states): How to read what's bookable right now.
- [Task lifecycle](https://docs.hannu.africa/task-types/lifecycle): The states a task passes through, and how it ends.

## SDKs
- [TypeScript SDK](https://docs.hannu.africa/sdks/typescript): Not shipped yet — generate a client from OpenAPI meanwhile.
- [Python SDK](https://docs.hannu.africa/sdks/python): Not shipped yet — generate a client from OpenAPI meanwhile.

## Platform
- [Pricing](https://docs.hannu.africa/platform/pricing): Where the numbers live, and how to read them.
- [Platform status](https://docs.hannu.africa/platform/status): Component health and uptime, by API and on the web.
- [Safety and policy](https://docs.hannu.africa/platform/policy): The refusals and privacy rules built into the platform.
- [How Operators work](https://docs.hannu.africa/platform/operators): Who does the work, and what you see of them.