> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool reference

> The MCP tools Zeno Budget serves to assistants, what each does, and the decisions that have no tool.

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](/docs/guides/assistant.md).

## 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

| Tool | What it does |
| - | - |
| `quickbooks_status` | The connection, the last sync, failures, and whether a reconnect is needed |
| `check_actuals` | Synced actuals against QuickBooks' profit and loss report. Owner and finance |
| `cash_flow` | The grid by period, with forecast, actual and projected |
| `cash_flow_cell` | The transactions and forecasts behind one figure |

## Programs

| Tool | What it does |
| - | - |
| `list_programs` | The programs you may see, and the QuickBooks classes and locations they can map to |
| `save_program` | Create or change a program. Owner and finance |
| `programs_from_quickbooks` | Make programs from classes or locations. Owner and finance |

## Forecasts and templates

| Tool | What it does |
| - | - |
| `forecast_options` | The categories, bank and card accounts, and programs you can forecast with |
| `list_forecasts` | Forecasts with their next date and total over a range, filterable |
| `get_forecast` | One forecast with its adjustments, discussion and history, and whether you can edit it |
| `create_forecast` | Add a forecast |
| `update_forecast` | Change a forecast. Needs `version` |
| `delete_forecast` | Delete a forecast |
| `forecast_occurrences` | A forecast's dated occurrences, with repetition and adjustments applied |
| `forecast_context` | A category's twelve-month history, and forecasts that may duplicate a new one |
| `comment_on_forecast` | Add to a forecast's discussion. Comments cannot be edited |
| `list_forecast_templates` | Saved templates |
| `save_forecast_template` | Save a template |
| `delete_forecast_template` | Delete a template |

## Budget cycles and change requests

| Tool | What it does |
| - | - |
| `budget_cycles` | Cycles and the cash reserve |
| `create_budget_cycle` | Open a cycle. Owner and finance |
| `review_budget_cycle` | Move a cycle to review, or reopen it. Owner and finance |
| `delete_budget_cycle` | Delete a cycle that was never locked. Owner and finance |
| `set_cash_reserve` | Set or clear the reserve. Owner and finance |
| `budget_as_locked` | The budget as it stood at the first lock |
| `propose_forecast_change` | Add a create, update or delete line to your draft change request |
| `remove_proposed_change` | Remove a line from your draft |
| `submit_change_request` | Submit your draft with a title and reason. Emails owner and finance |
| `withdraw_change_request` | Withdraw your submitted request |
| `list_change_requests` | Change requests you may see, by status |
| `waiting_on_me` | Requests to decide, sent back to you, and your draft |
| `get_change_request` | One request with its lines and timeline |
| `change_request_impact` | The request's impact on its programs, and for owner and finance on the organization's cash |
| `comment_on_change_request` | Comment on a request. Emails the other side |
| `remind_approvers` | Email the approvers again, at most once a day per request |

## Reports and the dashboard

| Tool | What it does |
| - | - |
| `budget_vs_actual` | The report for a range of up to twelve months |
| `export_budget_vs_actual` | The report as CSV, Excel or PDF |
| `dashboard` | Home's figures |

## Completeness

| Tool | What it does |
| - | - |
| `forecast_completeness` | Expectations from the last three years and how each is decided |
| `forecasts_from_history` | Make forecasts from history for open expectations |
| `mark_expectation` | Mark an expectation covered by a forecast, not this year, or open again |

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.