> For the complete documentation index, see [llms.txt](https://docs.brain.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brain.fi/build/overview.md).

# Overview

Each guide on this page solves one task end-to-end. Pick the one that matches what you're trying to ship; come back for the rest as you grow.

<table data-view="cards"><thead><tr><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🚪 Sign Up and Onboard</strong></td><td>Self-provision a sandbox tenant; log in as a human or point an agent at it.</td><td><a href="/pages/Nt6Djhan47XRxLlsq7iM">/pages/Nt6Djhan47XRxLlsq7iM</a></td><td></td></tr><tr><td><strong>📊 Read a Financial Picture</strong></td><td>Pull balances, transactions, obligations, and counterparties for a tenant.</td><td><a href="/pages/srQkJDeBIoVx1YJ6sLg6">/pages/srQkJDeBIoVx1YJ6sLg6</a></td><td></td></tr><tr><td><strong>💸 Pay an Invoice Safely</strong></td><td>Propose a payment, route to approval if needed, execute, get a receipt.</td><td><a href="/pages/EvXLQlWSFcn9RYDpmBqe">/pages/EvXLQlWSFcn9RYDpmBqe</a></td><td></td></tr><tr><td><strong>🛡 Give an Agent a Spending Limit</strong></td><td>Define a policy in plain English. Brain enforces it on every proposed action.</td><td><a href="/pages/Wnu4l8fn2PmQ5iXwBzAx">/pages/Wnu4l8fn2PmQ5iXwBzAx</a></td><td></td></tr><tr><td><strong>📜 Audit Every Action</strong></td><td>Pull a verifiable trail of what your agent (or user) did.</td><td><a href="/pages/Fypem4aaYkeJlDtrdFXd">/pages/Fypem4aaYkeJlDtrdFXd</a></td><td></td></tr><tr><td><strong>🔌 Let an External Agent In</strong></td><td>Authorize an MCP-compatible agent to read and propose on a tenant's behalf.</td><td><a href="/pages/QlSPCaWGQFEIUdhwQS8v">/pages/QlSPCaWGQFEIUdhwQS8v</a></td><td></td></tr><tr><td><strong>🧩 Use Brain Agent Skills</strong></td><td>Install task-specific recipes for Brain's MCP proposal surface.</td><td><a href="/pages/tamHWgSuhBgqD5sKK0PD">/pages/tamHWgSuhBgqD5sKK0PD</a></td><td></td></tr></tbody></table>

### What Every Guide Assumes

| Assumption                    | How to satisfy                                            |
| ----------------------------- | --------------------------------------------------------- |
| You finished the Quickstart   | The SDK is installed, your API key works, a tenant exists |
| You're in sandbox             | Production works the same way; sandbox is just safer      |
| You're calling from a backend | Server keys never go in client-side code                  |

```typescript
import { Brain } from "@brainfinance/sdk";

export const brain = new Brain({ apiKey: process.env.BRAIN_API_KEY });
```

### What You'll Keep Coming Back To

| Pattern                          | Where                                                                      |
| -------------------------------- | -------------------------------------------------------------------------- |
| The SDK methods you already know | Each guide reuses `brain.ask`, `brain.pay`, `brain.approve`, `brain.proof` |
| Idempotency keys                 | Required on every mutating call; retries are free                          |
| Trace IDs                        | Returned on every response; paste into the Console for the full timeline   |
| Webhooks                         | Subscribe once, get notified on the events you care about                  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.brain.fi/build/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
