Skip to main content
Glama
README.md
# Fairbrief: law firm accounting and operations agents

Thirty-two small MCP agents for the back office of a law firm. Each one owns **one job**, such as reconciling the trust account three ways, ageing unbilled time, checking a LEDES invoice before upload or checking the docket against the calendar, and cannot act outside it. They read the files your firm already exports from Clio, PracticePanther, MyCase, Smokeball, CosmoLex, PCLaw, Tabs3, Aderant, Elite 3E, QuickBooks and your bank, write worklists on your machine, and wait for one named person before anything is sent or signed.

None of them moves trust money, files anything with a court, makes a conflict decision or gives legal or ethics advice.

MIT license · Node 20 or newer · local files only · no credentials · no dependencies · client names masked before results reach the model

Also in: [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Italiano](README.it.md) · [日本語](README.ja.md) · [简体中文](README.zh-Hans.md) · [한국어](README.ko.md) (translated by Claude; native review pending)

## Try one

```bash
npx -y fairbrief-trust-reconciliation demo        # three-way trust reconciliation on fictional data
npx -y fairbrief-ledes-invoices demo              # a LEDES 1998B invoice checked before upload
```

Every agent has a `demo` that runs on fictional files, an `eval` that checks it against its own test cases, and an MCP server (`npx -y <agent> mcp --root <folder>`) for Claude Desktop, Claude Code, Cursor and other MCP hosts. Each agent's README lists what it checks, its tools and the columns it reads.

## The agents

**Client trust money**

| Agent | What it does | Waits for a person before |
|---|---|---|
| [`fairbrief-trust-reconciliation`](packages/fairbrief-trust-reconciliation) | Three-way reconciliation: bank statement, trust journal and client ledgers; deposits in transit, outstanding and stale checks, bank-only items, mismatches | The responsible lawyer signs the reconciliation |
| [`fairbrief-negative-balances`](packages/fairbrief-negative-balances) | Client ledgers below zero now or during the period, and disbursements made against deposits inside your hold days | Sending a shortfall memo |
| [`fairbrief-trust-transfers`](packages/fairbrief-trust-transfers) | Every transfer of fees out of trust against the invoice it pays: none, wrong matter, too early, too much | Never moves money |
| [`fairbrief-stale-trust-balances`](packages/fairbrief-stale-trust-balances) | Idle balances, money left on closed matters, residuals, balances old enough to check unclaimed-property rules | Sending a balance letter |
| [`fairbrief-retainers`](packages/fairbrief-retainers) | Advances in operating, billed fees left in trust, evergreen retainers below minimum, work beyond the retainer | Sending a replenishment request |
| [`fairbrief-commingling`](packages/fairbrief-commingling) | Client money in operating, firm money in trust, firm expenses paid from trust, round trips | Never moves money |
| [`fairbrief-settlement-statements`](packages/fairbrief-settlement-statements) | Settlement distribution sheets tied to the fee agreement and the trust journal; unpaid liens | Sending the statement to the client |

**Billing and collections**

| Agent | What it does | Waits for a person before |
|---|---|---|
| [`fairbrief-unbilled-time`](packages/fairbrief-unbilled-time) | Unbilled time by age bucket, matter and timekeeper; billable time with no rate | Never bills |
| [`fairbrief-wip-budgets`](packages/fairbrief-wip-budgets) | Work in progress against budgets, fee caps, flat fees and your billing cycle | Never bills |
| [`fairbrief-write-downs`](packages/fairbrief-write-downs) | Worked, billed, written down and written off by timekeeper and matter | Never writes off |
| [`fairbrief-realization-rates`](packages/fairbrief-realization-rates) | Billing, collection and overall realization by timekeeper, matter and practice area | Never changes pay |
| [`fairbrief-receivables-aging`](packages/fairbrief-receivables-aging) | Receivables by matter, client and lawyer; stalled payers, never-paid bills, credit balances | Sending a payment reminder |
| [`fairbrief-unbilled-costs`](packages/fairbrief-unbilled-costs) | Unbilled costs, firm-paid advances, costs on closed matters, missing expense codes | Never bills |
| [`fairbrief-billing-rates`](packages/fairbrief-billing-rates) | Each entry's rate against the rate card in force that day: old rates, client rates, caps, arithmetic | Never changes rates |
| [`fairbrief-billing-guidelines`](packages/fairbrief-billing-guidelines) | Entries against each client's billing guidelines as you write them down | Never uploads to e-billing |
| [`fairbrief-ledes-invoices`](packages/fairbrief-ledes-invoices) | LEDES 1998B files: totals, line arithmetic, UTBMS task, activity and expense codes, dates | Never uploads to e-billing |
| [`fairbrief-block-billing`](packages/fairbrief-block-billing) | Block-billed, vague, empty, clerical and thin narratives | Never edits entries |
| [`fairbrief-duplicate-entries`](packages/fairbrief-duplicate-entries) | Duplicate time and costs, impossible days, zero hours, no rate | Never deletes entries |

**Matters and deadlines**

| Agent | What it does | Waits for a person before |
|---|---|---|
| [`fairbrief-matter-intake`](packages/fairbrief-matter-intake) | New matters against your intake checklist by practice area; conflict checks dated after opening | Never edits matters |
| [`fairbrief-conflict-names`](packages/fairbrief-conflict-names) | Duplicate names, near spellings, former names, the same party on both sides, new names that match. No conflict decisions | Never clears a conflict |
| [`fairbrief-engagement-letters`](packages/fairbrief-engagement-letters) | Matters with no engagement letter, contingency matters with no written agreement, work before the letter | Sending a reminder to the lawyer |
| [`fairbrief-dormant-matters`](packages/fairbrief-dormant-matters) | Open matters with no activity, especially those holding trust money or unbilled work | Sending a status letter |
| [`fairbrief-matter-closing`](packages/fairbrief-matter-closing) | What is still open on a matter being closed: trust, deadlines, bills, unbilled work | Never closes a matter |
| [`fairbrief-docket-calendar`](packages/fairbrief-docket-calendar) | Docket and statute dates against the calendar export | Never writes to the calendar |
| [`fairbrief-deadline-gaps`](packages/fairbrief-deadline-gaps) | Overdue open deadlines, follow-ons your rule list expects, weekends and holidays, litigation with nothing ahead | Never files anything |

**Fees, people and the firm**

| Agent | What it does | Waits for a person before |
|---|---|---|
| [`fairbrief-origination-credit`](packages/fairbrief-origination-credit) | Origination credit splits, departed lawyers, credit on collections | Never changes pay |
| [`fairbrief-contingency-fees`](packages/fairbrief-contingency-fees) | Contingency fees recomputed from the agreement terms you enter | Never takes a fee |
| [`fairbrief-referral-fees`](packages/fairbrief-referral-fees) | Referral fees: agreements, consent, shares, amounts owed in both directions | Never pays |
| [`fairbrief-cle-hours`](packages/fairbrief-cle-hours) | CLE hours per lawyer against the requirements you enter for each state | Sending a reminder to the lawyer |
| [`fairbrief-bar-licenses`](packages/fairbrief-bar-licenses) | Bar license renewal dates; time recorded after every license lapsed | Never files renewals |
| [`fairbrief-insurance-policies`](packages/fairbrief-insurance-policies) | Malpractice and other policies: endings, gaps, retroactive dates, limits, lawyers not named | Never binds cover |
| [`fairbrief-timekeeper-capacity`](packages/fairbrief-timekeeper-capacity) | Hours against weekly capacity and annual target pace | Never assigns work |

## Rules differ by state: they are settings

Trust-accounting rules, hold days for deposits, notice before fees are taken from trust, unclaimed-property ages, CLE hours, referral fee limits, contingency caps and court deadline rules differ by state, court and client. None of them is built into these agents. Each lives in a small settings file the firm fills in, the bundled ones are labelled examples, and every result says when nobody at the firm has confirmed the settings (`confirmed_by`).

## How they stay safe

- **One job each.** An agent can only call its own tools; any other tool name, including ones a model invents, is blocked.
- **Refused tools are named.** Moving trust money, paying, filing with a court, uploading to e-billing, editing the practice-management system, clearing conflicts and sending e-mail are listed in each agent and blocked, so a model can see they exist and are refused.
- **One named click.** A draft (a reconciliation to sign, a reminder, a statement for a client) is written only after a person says yes, and approving it is one named click, even in Auto, tied to the sha256 of the reviewed draft; an edited draft needs a new click.
- **Client data masked.** Client, party, payee and referral-source names, matter names and bank account numbers become pseudonyms before a result reaches the model; the worklists written to disk keep the real names for the firm's staff.
- **Audit log.** Every call is a hash-chained line in `.fairbrief/audit.jsonl`, with arguments stored as a hash.
- **Hostile files.** Spreadsheet formulas, HTML, `../` paths and instructions aimed at an AI planted in every fixture are neutralised, refused or flagged (`npm run hostile`).

## Files from other countries

Every agent reads exports in nine languages through the shared core: German, French, Spanish, Portuguese, Italian, Japanese, Chinese and Korean column names, Windows-1252, Shift_JIS, GBK and EUC-KR text, `1.234,56` amounts and local date orders. Report pages follow `--lang de|fr|es|pt|it|ja|zh|ko`; the CSV worklists keep their column names. `npm run intl` re-runs every eval case on its fixtures rewritten for each language.

## Repository

| Command | What it does |
|---|---|
| `npm test` | Every package's tests (core and 32 agents) |
| `npm run evals` | Every agent's eval cases |
| `npm run hostile` / `npm run hostile:args` | Planted formulas, HTML, paths and AI-aimed text; broken arguments to every tool |
| `npm run intl` | Every spreadsheet eval case in eight more languages |
| `npm run bench` | Each tool on 1,000 and 10,000 rows |
| `npm run release:check:offline` | Honest-copy scan, secret scan, `npm pack` of every package |
| `npm run samples` | The HTML sample reports in `sample-reports/` |

Checks, numbers and what is not checked yet: [REVIEW-ver1.md](REVIEW-ver1.md). Shared core: [`fairbrief-core`](packages/fairbrief-core).

All data in this repository is fictional. Fairbrief is made by Mythos Machines.