For the complete documentation index, see llms.txt. This page is also available as Markdown.

Overview

Task-shaped guides. The patterns most apps need in their first hour.

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.

πŸšͺ Sign Up and Onboard

Self-provision a sandbox tenant; log in as a human or point an agent at it.

πŸ“Š Read a Financial Picture

Pull balances, transactions, obligations, and counterparties for a tenant.

πŸ’Έ Pay an Invoice Safely

Propose a payment, route to approval if needed, execute, get a receipt.

πŸ›‘ Give an Agent a Spending Limit

Define a policy in plain English. Brain enforces it on every proposed action.

πŸ“œ Audit Every Action

Pull a verifiable trail of what your agent (or user) did.

πŸ”Œ Let an External Agent In

Authorize an MCP-compatible agent to read and propose on a tenant's behalf.

🧩 Use Brain Agent Skills

Install task-specific recipes for Brain's MCP proposal surface.

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

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

Last updated