# Guides

URL: https://docs.hanzo.ai/docs/guides

> One task per page, each written four ways: a CLI command, an SDK call, an HTTP request and an MCP tool.

One key authenticates every request. `sk-` keys resolve to a user and belong on a server; `pk-` keys resolve only to an organisation and are safe in a browser.

```bash
export HANZO_API_KEY=sk-...     # console.hanzo.ai
hanzo auth login                # or sign in through Hanzo IAM
```

## Four surfaces, one contract

The CLI, the SDKs, the HTTP API and the MCP tools are generated from the same OpenAPI document. A command, a method, a path and a tool that do the same thing are the same operation under four names, so what you learn on one surface holds on the others.

| Surface | Address                                          |
| ------- | ------------------------------------------------ |
| CLI     | `hanzo <capability> <verb>`                      |
| SDK     | a method per operation, in your language         |
| HTTP    | `https://api.hanzo.ai/v1/<capability>`           |
| MCP     | one tool per capability, dispatched by operation |

## Tasks

Each page below does one thing, and does it on all four surfaces.

- [Hello](https://docs.hanzo.ai/docs/guides/hello): Identity — prove the key works and print who it belongs to.
- [Chat](https://docs.hanzo.ai/docs/guides/chat): One completion.
- [Money](https://docs.hanzo.ai/docs/guides/money): Balance, then the usage that moved it.
- [Store](https://docs.hanzo.ai/docs/guides/store): KV round-trip — create a store, read it back, delete it.
- [Agent](https://docs.hanzo.ai/docs/guides/agent): Create an agent, run it, read the run back.
- [Tools](https://docs.hanzo.ai/docs/guides/tools): List the MCP tools this key can reach.

## Cookbook

Zen, Enso and Kai in one loop — route a request, triage with typed answers, gate an agent's command, drive an agent from programs: [the cookbook](https://docs.hanzo.ai/docs/guides/cookbook).

Every capability the API serves is in the [reference](https://docs.hanzo.ai/docs/openapi), and the same key reaches all of it.