# Brynth

> I/O for AI agents: one address to receive, one key to act, one record of everything.

Brynth gives an AI agent an inbox for webhooks and email, a disk for files and task state, email sending, approvals from people by email or Telegram, and a hash-chained ledger of every effect. Agents connect over MCP (`https://mcp.brynth.ai/mcp`) or REST (`https://api.brynth.ai/v1`) with a project key. Set up with `npx brynth init`. Every page is available as Markdown at the same path with `.md`.

## Docs

- [Quickstart](https://brynth.ai/quickstart.md): from nothing to the first event with `npx brynth init`
- [Claude Code](https://brynth.ai/get-started/claude-code.md): connect, the skill, disconnect
- [Codex](https://brynth.ai/get-started/codex.md): the `config.toml` table, timeouts, `codex exec`
- [Other MCP clients and REST](https://brynth.ai/get-started/other-clients.md): keys, scopes, URLs

## Guides

- [Stripe webhooks in Claude Code](https://brynth.ai/guides/stripe-webhooks.md): a verified Stripe source
- [Your agent asks permission on Telegram](https://brynth.ai/guides/telegram-approvals.md): `ask_approval`, resuming with `state_ref`
- [Hand off a task from Claude Code to Codex](https://brynth.ai/guides/claude-code-to-codex.md): shared task state
- [Receive email](https://brynth.ai/guides/receive-email.md): the project address and `email.received`
- [Send email](https://brynth.ai/guides/send-email.md): `email_send` under the policy
- [Files and task state](https://brynth.ai/guides/files-and-state.md): key-value, files, `state_save`
- [Use a project from another machine](https://brynth.ai/guides/another-machine.md): `BRYNTH_KEY`

## Reference

- [MCP tools](https://brynth.ai/reference/mcp-tools.md): every tool with its scope and parameters
- [Errors](https://brynth.ai/reference/errors.md): codes, HTTP status, hints
- [Limits](https://brynth.ai/reference/limits.md)
- [CLI](https://brynth.ai/reference/cli.md)
- [REST](https://brynth.ai/reference/rest.md): routes and the OpenAPI document

## Optional

- [Events and the envelope](https://brynth.ai/concepts/events.md)
- [Requests and policy](https://brynth.ai/concepts/requests-and-policy.md)
- [The ledger](https://brynth.ai/concepts/ledger.md)
- [Security](https://brynth.ai/security.md)
- [Full documentation in one file](https://brynth.ai/llms-full.txt)