Bazous

Bazous answers a household's money questions before anyone asks: what is available, what is due before payday, how low the balance goes and the best payment…

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

Get Household Answers: Budget overview and answers: Bazous's complete, ready-made answer to any question about the household's money, such as "how is my budget doing?", "où en est mon budget ?", "am I
Update Household Profile: Saves profile facts the household gives: health insurance premiums, the last tax bill, pillar 3a contributions, contract end dates. The adviser's answers need them. Only the
Complete Household Profile: Collects the facts an answer `needs` for one profile section, saves them and returns the updated answers. `section` is the part of the need before the dot (e.g. "taxes.last

What data it sees

Do you need an account

No: the server works without sign-in

Bazous answers a household's money questions before anyone asks: what is available, what is due before payday, how low the balance goes and the best payment to move. Each answer is drawn as a card in Claude and ChatGPT. Read-only by default; profile facts and paid bills are saved only on request. No bank connection, no payments.

How to connect

How to connect Bazous to Claude

The server address to paste into Claude settings:

https://bazous.run.tools

Open Claude (claude.ai or the desktop app).
Go to Settings → Connectors.
Click Add custom connector.
Paste the server address copied below into Remote MCP server URL and click Add.
In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Bazous to ChatGPT

The server address to paste into ChatGPT settings:

https://bazous.run.tools

Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
Open Settings → Connectors and click Create.
Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Bazous to Cursor

The server address to paste into Cursor settings:

https://bazous.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (9)

Raw names from tools/list. Only developers need these.

get_household_answers	Budget overview and answers: Bazous's complete, ready-made answer to any question about the household's money, such as "how is my budget doing?", "où en est mon budget ?", "am I wasting money on fees?", "what do I have to pay before payday?", "what if I move a payment?" or "can I afford it until payday?". Each answer is drawn as a Bazous card. Use it for any question about the household's money, and again with `question` set to the topic's id for each follow-up topic, so the card shows that answer alone with today's figures. It covers how much is available, what is due before payday, how low the balance goes, what will be left, the best payment to move, which decisions to make, what a month costs, whether a pay cycle eats into reserves, and an adviser's questions (a big yearly bill, how long the cushion lasts, losing one income, avoidable bank fees found in the transactions, health insurance, tax provision, pillar 3a, contract notice). Returns `headline`; `answers`, most urgent first, each with a tone (risk, warn, info), the exact figures computed by the Bazous engine and, where useful, the reason; `all_clear`, one short line per topic that is fine; and `missing_data`. With `question` set to a topic id, the result and the Bazous card hold that answer alone, with its picture; `focus_missing` is set when Bazous has no answer to that question for this household today. Topic ids: available-now, due-before-payday, low-point, margin-after-payday, what-if (the payment the engine would move), next-actions, monthly-structure, pay-cycles, annual-bills, safety-cushion, income-loss, avoidable-fees (bank fees), health-insurance, tax-provision, pillar-3a, contract-notice. `language` is fr, de, it, rm or en.
update_household_profile	Saves profile facts the household gives: health insurance premiums, the last tax bill, pillar 3a contributions, contract end dates. The adviser's answers need them. Only the sections passed are replaced; the others are kept. Returns the saved profile. Use it when the user has just given a fact that an answer `needs`.
complete_household_profile	Collects the facts an answer `needs` for one profile section, saves them and returns the updated answers. `section` is the part of the need before the dot (e.g. "taxes.last_annual_bill" -> "taxes"). Where the app shows forms, the user fills in a short form and the figures go straight to Bazous, outside the conversation. `values`, keyed like `fields`, saves facts the user has already given, without a form; the Bazous card uses it for its own form. Returns `status`: "saved" (with the updated `answers`), "declined", "invalid" (with an `error`) or "ask_in_chat" (no form here; `fields` lists the facts needed).
get_household_snapshot	Raw data: account names, types and currencies, and next-income totals. Figures only, with no analysis, fees or advice. Use it when the user asks for this detail; a budget question or an overview is answered by get_household_answers.
get_upcoming_obligations	Raw data: the list of known unpaid bills, overdue and undated ones included, with the IDs a simulation or a paid bill needs. Figures only, with no analysis. Use it when the user asks for this detail; a budget question or an overview is answered by get_household_answers.
get_pay_cycle_forecast	Raw data: the conditional forecast until next payday, computed from recorded balances and events. Figures only, with no analysis. Use it when the user asks for this detail; a budget question or an overview is answered by get_household_answers.
get_cash_safety_brief	Raw data: today's cash-safety signal and its assumptions, computed on demand. Figures only, with no analysis. Use it when the user asks for this detail; a budget question or an overview is answered by get_household_answers. It does not monitor in the background or send alerts. Missing balances, dates or exchange rates prevent a confident estimate.
simulate_payment_change	Compares a payment scenario with the current forecast, without saving anything. `move` gives a visible bill another date, `remove` leaves it out, `add` adds a payment in the household currency. Returns `baseline`, `scenario` and `persisted: false`; the stored bills are unchanged. Use it when the user names a payment, a date or an amount; the engine's own best move is the `what-if` answer of get_household_answers.
mark_obligation_paid	Records that the user has paid a bill. It moves no money and cannot be undone in the product; the idempotency key makes a retry safe. Use it only when the user says a bill is paid and asks to record it.