add_chapter
ChatGPTAdd a new, empty chapter to a company's plan — a top-level chapter like "Risks" or "Appendix", not a section inside one (that's add_section). It goes at the end unless afterChapterId says where. Then fill it with add_section using the returned chapterId — typed sections following the chapter recipes from list_section_types.
add_forecast_item
ChatGPTAdd one stream to a company's financial forecast — a revenue stream, a cost of sales, an operating expense, a payroll role, an asset, funding or a dividend — with the assumptions its type takes (the types and their fields are in list_forecast_types; required ones are marked). Which group it goes in is the user's choice. Called without groupId or groupName, it saves nothing and returns the groups it can go in, for the user to pick an existing one or name a new one (by default named like the stream). The next call carries their choice, with their reply naming the group in userReply; the server refuses a group the user wasn't asked about. A cost that follows a revenue stream goes in that revenue group. The assumptions are saved and the app works out the figures when the forecast is next opened in the app. Month-by-month amounts are not available here.
add_media_section
ChatGPTAdd a picture or an embedded link to a chapter of a company's plan. kind=image: url must be a DIRECT link to the image file (JPG, PNG, WebP, GIF, SVG) — it is downloaded into the company's media library, so the plan keeps it even if the site changes. Use only images the user gave you or asked for, and that they may use. kind=embed: a YouTube/Vimeo/Loom video, a Figma or Canva design, a Google Sheet/Slides/Doc, or any web page (a page without a player shows as a link card). Optional title and, for an image, a caption. Additive only; the chapter as it was before this run of connector changes is kept as one version. Placed after afterSectionId (a sectionId from get_chapter_sections, or "start"), or at the end of the chapter.
add_section
ChatGPTAdd ONE new section of any type to a chapter of a company's business plan — a text section, SWOT, competitor, customer persona, milestones, pricing plans, a chart, a finance block, and so on. Plans are built from typed, titled sections — a heading plus a fitting block for each idea; a chapter written as TEXT only loses the designed layouts. list_section_types with no type gives each chapter's usual recipe, and with a type gives the fields that type takes, passed here as data; the section is built as the app builds it. A TEXT or SECTION_TOPIC body written with headings, "Label: text" lists or tables becomes the matching typed sections. About the content: people, prices, metrics and market figures in a plan come from the user or from a source that can be named, cited in the section text as <fn>publisher — https://url</fn>; a section whose key figures aren't known yet is usually better asked about than added with blanks. Money amounts (market size, use of funds, currency charts) are in the company's currency (list_companies shows it), with currency set; a converted amount states its rate in the text. Figures the Finance forecast holds (revenue, profit, costs, cash, payroll, break-even) go in a FINANCE_BLOCK preset, which reads the live forecast; CUSTOM_CHART is for data the user supplies. The reply lists any field left blank. Additive only: nothing existing changes, and the chapter as it was before this run of connector changes is kept as one version. Placed after afterSectionId (a sectionId from get_chapter_sections, or "start"), or at the end of the chapter. Pictures and embedded links (videos, designs, sheets) are add_media_section.
create_plan_version
ChatGPTSave the whole plan of a company as a named version (the app's "Create version"): every chapter, the cover and the comments, numbered V1, V2, … Nothing in the plan changes. Only the company owner can save versions. Ask the user for the title if they didn't give one; a good moment to offer this is before a big round of changes.
delete_forecast_item
ChatGPTPermanently delete one stream from a company's financial forecast. Costs and expenses worked out from it (a cost per unit it sells, a share of it, a cost per head of a role) are deleted with it, and the finance forecast keeps no versions, so nothing brings them back. It works in two steps. Called without confirm, it deletes nothing and returns a preview listing everything that would go. The user's approval has to name the stream (e.g. "Yes, delete Coffee beans"). The second call repeats the same ids with confirm: true and that reply word for word in userReply; the server refuses a reply that doesn't name the stream, such as a bare "yes".
duplicate_chapter
ChatGPTMake a full, independent copy of a chapter — every section — placed right after the original and titled "<title> (copy)". Rename it with update_chapter if the user wants.
get_actuals_vs_plan
ChatGPTCompare a company's recorded actual results with its forecast: revenue, gross profit, operating expense, net profit and ending cash, planned vs actual and the difference, over the periods that have actuals (entered by hand or synced from Xero / QuickBooks). When no actuals are recorded it says so. Read-only.
get_chapter_sections
ChatGPTList the sections inside one chapter of a company's plan, in order — each with its sectionId, type, everything it holds (text AND numbers), and how update_section can change it: text (rewrite the prose), data (send its complete new content), finance (figures come from the forecast — not editable as data) or none. Call this before update_section, and for afterSectionId in add_section. Read-only.
get_dashboard_data
ChatGPTRead one category of a company's Finance dashboard in detail, actual vs plan for the judged month and year to date: revenue (each stream, with its trend), expenses (payroll, cost of sales, general expenses, bad debt), profitability (net income, gross margin, break-even, the rest of the year and next year) or cash (ending cash, the lowest month ahead, when it would go negative, committed outflows). Read-only.
get_dashboard_summary
ChatGPTRead a company's Finance dashboard the way the app shows it: the month it is judged at (the last complete month with actuals, or this month's plan when none are recorded), revenue, expenses, net income and ending cash as actual vs plan, and the cards that need attention — streams under or over plan, expense lines over plan, a slipping gross margin, a planned launch with no revenue. Lists the categories get_dashboard_data can open. Read-only.
get_finance_settings
ChatGPTRead what a company's forecast is built on: plan start, length, fiscal year and currency; income tax and sales tax / VAT; customer and supplier credit terms; opening balances; where actuals come from (manual, Xero or QuickBooks, with the account mapping); and which settings are not set up yet, with links to set them. Read-only.
get_finance_summary
ChatGPTGet the yearly financial forecast summary of one company: revenue, gross profit and margin, operating expenses, net profit and ending cash per year, plus break-even, cash runway, any extra funding needed, and issues worth checking in the forecast. Read-only. Use for questions like "how is my business doing financially?" or "when do we break even?". Quote figures in the currency given — never convert or assume dollars. Pass the company id from list_companies.
get_financial_statement
ChatGPTRead one to four of a company's financial statements from its forecast, row by row, yearly, quarterly or monthly — the same figures as Finance → Reports in the app, planned alongside actual where actuals are recorded. Statements: incomeStatement, balanceSheet, cashFlow, breakEven, ratioAnalysis, workingCapital, revenue, costOfSales, expenses, payroll, assets, funding, dividends, accountsReceivable, accountsPayable, incomeTax, salesTax, inventory. Each comes with its currency, plan window and how it is calculated. Read-only.
get_forecast_items
ChatGPTRead one section of a company's financial forecast as Finance → Forecast shows it: its groups and, in each, the streams with their ids, type (e.g. a product sold per unit, a subscription, a fixed monthly cost, a percentage of revenue, a loan), the assumptions that type uses (price, units, growth, amount, percentage, what it is worked out from), start and end month, yearly totals, and whether it is calculated, waiting for calculation or excluded. Sections: revenue, costOfSales, expenses, payroll, assets, funding, dividends. Read-only. Streams are changed with update_forecast_item and groups renamed with rename_forecast_group.
get_plan_outline
ChatGPTGet the chapter structure (titles and order, no content) of one company's business plan. Pass the company id returned by list_companies.
get_plan_section
ChatGPTGet the full written content of one chapter of a company's business plan. Pass the company id (from list_companies) and the chapter id (from get_plan_outline).
list_companies
ChatGPTList the businesses (companies) the connected user belongs to. Returns each company's id, name, industry and currency — every amount in that company's plan is shown in its currency. Use the id with get_plan_outline.
list_forecast_types
ChatGPTThe kinds of stream each forecast section offers and the assumptions each kind takes — e.g. revenue: unit sales, per-service charges, subscriptions, hourly, fixed; expenses: constant amount, per unit, per employee, % of revenue, % of another expense, month by month; funding: loan, line of credit, equity. The same for every company. Read-only.
list_plan_versions
ChatGPTList a company plan's saved versions, newest first. Without chapterId: the whole-plan versions the owner saved by name (V1, V2, …). With chapterId: that chapter's versions (v1, v2, …), including the "Before changes via connector" snapshot saved automatically before a run of add_section / update_section changes (one per run, not per change) — use these to undo connector changes. Needs edit access to the plan.
list_section_types
ChatGPTThe kinds of section that can be added to a business plan chapter — text, strategy (SWOT, PESTEL, Porter's Five Forces…), market (market size, competitor, customer persona…), product, people, progress, charts and finance blocks — plus how the app composes each chapter from them (Executive Summary, Market Analysis, Team, Financial Plan…). Call with no type for the list and the chapter recipes, before writing or restructuring a chapter; call with a type to get the fields that type takes, before add_section. Read-only.
rename_forecast_group
ChatGPTRename a group in a company's financial forecast — the heading its streams sit under. The streams in it and their figures stay as they are. The group's id comes from get_forecast_items. A name another group in the same section already has is refused. Renaming a stream is update_forecast_item, not this.
restore_plan_version
ChatGPTPut a plan back to a saved version. With chapterId: only that chapter goes back to one of its versions (from list_plan_versions with that chapterId) — the way to undo an add_section / update_section. Without chapterId: the WHOLE plan is replaced by a saved plan version (owner only). The current state is saved as a backup version first either way. Without confirm the call changes nothing and returns a preview of what would be restored. With confirm: true, the same ids, and the user's approving reply in userReply, it restores — the server accepts only a reply that names the version or chapter (such as "Yes, restore v3 of Market Analysis") and refuses a bare "yes".
update_chapter
ChatGPTRename a chapter, move it to another place in the plan, or both. Its content isn't touched. To move it, pass afterChapterId.
update_forecast_item
ChatGPTChange one stream in a company's financial forecast: its name, its assumptions (price, units, growth, amount, percentage, salary, loan terms, what it is worked out from…), its first or last month, or its type. Only what is given changes; the rest stays as it is. The stream's id comes from get_forecast_items, and the fields each type takes from list_forecast_types. The app works the figures out again when the forecast is next opened in the app. A value entered month by month in the app can be replaced with one constant value, not edited month by month. This changes a stream; renaming the group it sits in is rename_forecast_group.
update_section
ChatGPTChange ONE existing section of a company's plan in place — same id, same position. Check its edit kind in get_chapter_sections first. edit=text: send text, the full new body (blank lines split paragraphs; bold and <fn>publisher — https://url</fn> citations work) and/or title. edit=data: send data, the section's COMPLETE new content in its type's shape (list_section_types with the type) — start from what get_chapter_sections shows and change only what the user asked; a field you leave out ends up blank. The same rules as add_section apply: no invented figures, sourced ones cited, money in the company's currency with currency. Without confirm the call changes nothing and returns a before/after preview of the section; with confirm=true and the same content it applies that change. As with add_section, the chapter as it was before this run of connector changes is kept as one version, which restore_plan_version can bring back.