{
  "markdown": "# 13-Week Cash Flow Forecast\n\nAnswers the question people actually open a cash flow tool to ask:\n**which week does the cash go negative, and by how much?**\n\nSix figures in — opening cash balance, expected receipts, supplier payments,\npayroll, loan instalments, and VAT or taxes due. Out comes the 13-week grid,\nthe break-even week, the peak funding need across the period, the levers that\nwould move the date, and a **live Excel workbook** with real formulas you can\nkeep working in.\n\nDon't know your receipts? Give revenue and DSO instead and it converts. Same\nfor purchases and DPO on the payables side. One number per line if your weeks\nare flat, thirteen if you have the detail.\n\n---\n\n## Three ways to use it\n\n### 1. Desktop extension — nothing leaves your machine\n\nThe best version, and the one to pick if the figures are a client's.\nThe server runs locally and writes the workbook straight to your disk. No\naccount, no token, no upload.\n\nDownload **`cashflow13-*.mcpb`** from\n[Releases](https://github.com/ledgerworks-io/cashflow13/releases),\nthen in Claude Desktop: Settings → Extensions → drag the file in.\n\n### 2. Remote server — the shortest path\n\nNo account and no token. In Claude Desktop, Settings → Connectors → Add custom\nconnector:\n\n```\nhttps://mcp.chiriba.it/mcp\n```\n\nIn Claude Code:\n\n```bash\nclaude mcp add --transport http cashflow13 https://mcp.chiriba.it/mcp\n```\n\nListed in the official MCP registry as **`it.chiriba/cashflow13`**.\n\n### 3. Apify Actor\n\nApify Standby requires **your own Apify API token** — that is the platform's\nrule, not ours. Append it to the URL:\n\n```\nhttps://ledgerworks--cashflow13.apify.actor/mcp?token=YOUR_APIFY_TOKEN\n```\n\nIf you would rather not have an account at all, use one of the two above.\n\n---\n\n## What it gives back\n\n- the week-by-week grid with the closing cash balance\n- **the first week the balance turns negative**, and the shortfall in that week\n- the **peak funding need** over the 13 weeks — the cumulative low point, which\n  is a different number from the first shortfall, and the one your bank will ask for\n- levers, each with the weeks it buys and the change in funding need:\n  collecting 15 days earlier, paying suppliers 15 days later, moving payroll a week\n\nThe levers never make an outflow disappear. Moving payroll a week pushes the\nlast payment past week 13, and the answer says so — deferred, not saved.\n\n## The workbook\n\nYellow cells are inputs. Everything else is a formula. Change a weekly figure\nand the grid, the break-even week and the funding need all move; change the\nstart date in one cell and all thirteen weeks follow. It recalculates on open,\nbecause no cached values are written — it is the model, not a picture of one.\n\nWeeks end on **Friday** by default: US practice, and where payroll and bank\ncut-offs fall. Configurable, and written into the workbook header so whoever\nreceives the file knows what convention they are reading.\n\n## Your figures\n\nNo database, no history, no account, nothing kept.\n\n- **Desktop extension** — the numbers never leave your computer.\n- **Remote server** — the workbook is held in memory for 60 minutes, never\n  written to disk, then forgotten.\n- **Apify** — the workbook sits on Apify's storage for at most 20 minutes,\n  then is deleted whether it was downloaded or not.\n\n---\n\n## Development\n\n```bash\nnpm install\nnpm test          # tests are written before the code\nnpm run typecheck\nnpm run build\nnpm run bundle    # builds the .mcpb desktop extension\nnpm run release   # full release chain; stops before anything leaves the machine\n```\n\n| Path | What lives there |\n|---|---|\n| `src/engine/calendar.ts` | The 13 week-ending dates, all in UTC |\n| `src/engine/plan.ts` | The grid, the first negative week, the peak funding need |\n| `src/engine/levers.ts` | What would move the date |\n| `src/engine/working-capital.ts` | Revenue + DSO → weekly receipts |\n| `src/excel/workbook.ts` | The live workbook |\n| `src/delivery/` | How the file reaches you, and **why** each way exists |\n| `src/i18n/strings.ts` | **The localization table.** Every user-facing label. |\n\n### Rules that shaped this\n\n- **No user-facing string is hardcoded** — it goes in the localization table, in\n  English and Italian. A test fails if a key is missing a language, or if an\n  Italian string is a copy-paste of the English.\n- **Tests before code.** For a financial tool, correctness *is* the product.\n  A balance of exactly zero is not negative. Money rounds to the cent at every\n  step, because `0.1 + 0.2` does not make `0.3` and a plan that says \"you are\n  overdrawn\" when you are not is worse than no plan.\n- **No storage.** That is also the GDPR answer.\n- **One engine, many tools.** The next tools are new functions on this server,\n  not new projects.\n\n## Licence\n\n[Business Source License 1.1](LICENSE). In plain terms:\n\n- **Use it for anything**, including your own professional work — an accountant\n  or controller running this for a client, and billing that client, is fine.\n- **You may not hand it to third parties for a fee so they can use it\n  themselves** — not as a product, not as a hosted service, not embedded in\n  other software.\n- Four years after each version is published, that version becomes\n  **Apache 2.0** and the restriction lapses.\n\nNot OSI-approved, deliberately: the tool is free to use and stays free to use,\nbut the option to charge for it later is kept open.\nFor other arrangements: `info@chiriba.com`.\n\n---\n\n## Also in this repository\n\n**[Dataset Audit](https://apify.com/ledgerworks/dataset-audit)** — you paid per\nresult; it tells you what you got. Duplicates, records that ignored the filters\nyou asked for, and the real cost per usable record, with a live Excel receipt.\nFree. Source in [`actors/dataset-audit/`](actors/dataset-audit/), same engine as\nthis one.\n",
  "bytes": 5791,
  "sha": "41edeba48c6ba1d88bcbcff5131a3f0bee61d6a1c9774fd8d9c069219da554f4",
  "repo_slug": "ledgerworks-io/cashflow13",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_it_chiriba_cashflow13_7a250e84/readme"
}