Skip to main content
Zeno Budget serves its tools over MCP (streamable HTTP) at https://app.zenobudget.com/mcp. Clients connect with OAuth 2.1, dynamic client registration and PKCE; discovery is at /.well-known/oauth-authorization-server. A person approves the connection for the organization they are working in, and the token acts as that person: their role is read again on every call, so a tool refuses what the console would refuse. For a person setting up Claude or ChatGPT, see Connect your assistant.

Conventions

  • Amounts are integer cents unless a tool says otherwise.
  • A change to a forecast carries its version (the updatedAt you read). If someone changed it since, the tool answers changed_since: read it again before changing it.
  • Inside a locked cycle, a forecast write answers budget_locked. Propose the same change with propose_forecast_change instead.
  • Actuals are as fresh as the last sync. Read quickbooks_status before relying on one.

QuickBooks and cash flow

Programs

Forecasts and templates

Budget cycles and change requests

Reports and the dashboard

Completeness

Cards

Most tools draw a card in clients that support MCP Apps: the QuickBooks connection, forecasts and a forecast, the cash flow and a figure’s drilldown, programs, budget vs actual, the dashboard, budget cycles, change requests and a change request, and forecast completeness. Cards only read. A button on a card posts the person’s words into the chat, except the decision buttons on the change request card.

Decisions kept for people

These have no tool, and the service refuses them from an assistant token:
  • approving, rejecting or sending back a change request;
  • locking or unlocking a budget cycle;
  • people, roles and program assignments;
  • connecting or disconnecting QuickBooks;
  • share links and assistant tokens.
The change request card carries Approve, Approve ticked lines, Send back and Reject for an approver. Those buttons call the server with a key signed for that card, so only the approver’s click can use them; the model cannot.