Public log

beeswax-mcp

Official MCP server for Beeswax (beeswaxapp.com) — query invoices, quotes, expenses, payments, journals, time entries, projects, products & services and tax returns from Claude and other MCP clients, and build quotes priced from your catalogue.

npm · fingerprint 546fc1af314483cbf3e04583 · repository · RSS

169tools
2recorded versions
45dtracked
changed since 11 Oct

What changed

Changed between 11 October 2026 and 18 November 2026 (first seen 2026-11-18 15:54 UTC)

21 descriptions rewritten, 25 tools added, 3 tools removed.

+ tool added: add_year_end_review_note

+ tool added: attach_task_file

+ tool added: balance_sheet

--- pinned/create_bank_reconciliation
+++ observed/create_bank_reconciliation
  {
-   "description": "Create a statement check for a bank account. Either give the statement period and balances (start_on, finish_on, opening_balance, closing_balance) to start ticking immediately, or give file_path (a local statement PDF) and Beeswax extracts the period and balances and runs its own matcher first — the result is pending_statement until get_bank_statement_status reports completed. Requires reconciliations:write and an owner or accountant role.",
+   "description": "Create a bank reconciliation for a bank account. Either give the statement period and balances (start_on, finish_on, opening_balance, closing_balance) to start ticking immediately, or give file_path (a local statement PDF) and Beeswax extracts the period and balances and runs its own matcher first — the result is pending_statement until get_bank_statement_status reports completed. Requires reconciliations:write and an owner or accountant role.",
    "inputSchema": {
      "properties": {
        "bank_account_id": {

+ tool added: create_bank_transfer

--- pinned/create_expense
+++ observed/create_expense
  {
-   "description": "Create a whole expense (supplier bill) in one call — header, sections and each section's lines. LIFECYCLE: creating lands a DRAFT — numbered, but NOT on the ledger, not in tax reporting and not sent to Xero until you call finalise_expense. A finalised unpaid expense can still be edited in place; once a payment is recorded it is locked. There is no way back to draft: a finalised expense that should not exist is voided (void_expense), never deleted. Nothing here emails anyone. Pass status:\"finalised\" to post it in the same call (refused, and nothing is created, if the total is negative, the project is locked, or the date falls on or before the account lock date). Price lines from the catalogue with transaction_template_id where you can (buy-side account, tax and rate are inherited). project_id is required; company_id defaults as described. Every id must belong to your account — resolve them with list_projects, list_companies, list_transaction_accounts, list_taxes. Requires expenses:write.",
+   "description": "Create a whole expense (supplier bill) in one call — header, sections and each section's lines. LIFECYCLE: creating lands a DRAFT — numbered, but NOT on the ledger, not in tax reporting and not sent to Xero until you call finalise_expense. A finalised unpaid expense can still be edited in place; once a payment is recorded it is locked. There is no way back to draft: a finalised expense that should not exist is voided (void_expense), never deleted. Nothing here emails anyone. Pass status:\"finalised\" to post it in the same call (refused, and nothing is created, if the total is negative, the project is locked, or the date falls on or before the account lock date). Price lines from the catalogue with transaction_template_id where you can (buy-side account, tax and rate are inherited). project_id is required; company_id defaults as described. Overheads that belong to no client project (utilities, rates, rent, subscriptions) go on the account's internal project (internal:true in list_projects). Every id must belong to your account — resolve them with list_projects, list_companies, list_transaction_accounts, list_taxes. Requires expenses:write.",
    "inputSchema": {
      "properties": {
        "company_id": {
+       "external_amount": {
+         "description": "The total the supplier's invoice states. The web page flags it when it differs from the bill's total. null clears it.",
+         "type": [
+           "number",
+           "null"
+         ]
+       },
+       "external_note": {
+         "description": "Note on the Supplier Invoice card. An AI receipt draft's note starts 'Auto-created from'; replacing it stops that draft being offered as a receipt for its bank line.",
+         "type": "string"
+       },
        "external_number": {
-         "description": "The supplier's own invoice number.",
+         "description": "Supplier Invoice No — the supplier's own invoice number.",
          "type": "string"
        },
        "groups": {
-         "description": "Project the document belongs to. Required.",
+         "description": "Project the document belongs to. Required. Overheads that belong to no client project (utilities, rates, rent, subscriptions) go on the account's internal project (internal:true in list_projects).",
          "type": "integer"
        },
        "sent_on": {
--- pinned/create_invoice
+++ observed/create_invoice
  {
-   "description": "Create a whole invoice in one call — header, sections and each section's lines. LIFECYCLE: creating lands a DRAFT — numbered, but NOT on the ledger, not in tax reporting and not sent to Xero until you call finalise_invoice. A finalised unpaid invoice can still be edited in place; once a payment is recorded it is locked. There is no way back to draft: a finalised invoice that should not exist is voided (void_invoice), never deleted. Nothing here emails anyone. Pass status:\"finalised\" to post it in the same call (refused, and nothing is created, if the total is negative, the project is locked, or the date falls on or before the account lock date). Price lines from the catalogue with transaction_template_id where you can (sell-side account, tax and rate are inherited). project_id is required; company_id defaults as described. Every id must belong to your account — resolve them with list_projects, list_companies, list_transaction_accounts, list_taxes. Requires invoices:write.",
+   "description": "Create a whole invoice in one call — header, sections and each section's lines. LIFECYCLE: creating lands a DRAFT — numbered, but NOT on the ledger, not in tax reporting and not sent to Xero until you call finalise_invoice. A finalised unpaid invoice can still be edited in place; once a payment is recorded it is locked. There is no way back to draft: a finalised invoice that should not exist is voided (void_invoice), never deleted. Nothing here emails anyone. Pass status:\"finalised\" to post it in the same call (refused, and nothing is created, if the total is negative, the project is locked, or the date falls on or before the account lock date). Price lines from the catalogue with transaction_template_id where you can (sell-side account, tax and rate are inherited). project_id is required; company_id defaults as described. General income that belongs to no client project goes on the account's internal project (internal:true in list_projects). Every id must belong to your account — resolve them with list_projects, list_companies, list_transaction_accounts, list_taxes. Requires invoices:write.",
    "inputSchema": {
      "properties": {
        "company_id": {
+       "external_amount": {
+         "description": "The amount the purchase order states. null clears it.",
+         "type": [
+           "number",
+           "null"
+         ]
+       },
+       "external_note": {
+         "description": "Note beside the purchase order number.",
+         "type": "string"
+       },
+       "external_number": {
+         "description": "The client's purchase order number.",
+         "type": "string"
+       },
        "groups": {
          "description": "Sections, in order.",
          "items": {
-         "description": "Project the document belongs to. Required.",
+         "description": "Project the document belongs to. Required. General income that belongs to no client project goes on the account's internal project (internal:true in list_projects).",
          "type": "integer"
        },
        "sent_on": {
--- pinned/create_manual_journal
+++ observed/create_manual_journal
  {
-   "description": "Create a manual (general) journal entry — the double-entry primitive behind every accounting adjustment that is not an invoice or expense (depreciation, accruals, asset disposals, reclassifications, opening balances, tax provisions, dividends). Finalised (posted to the ledger) on create by default, like every other Beeswax journal. Pass status: \"draft\" to stage it for review instead (then finalise_manual_journal). Rules enforced by the API: two or more lines; each line has account_id (a chart-of-accounts transaction_account id) and exactly one of debit or credit as a positive number; total debits MUST equal total credits; every account must belong to this account. Requires a token with the journal_entries:write scope.",
+   "description": "Create a manual (general) journal entry — the double-entry primitive behind every accounting adjustment that is not an invoice or expense (depreciation, accruals, asset disposals, reclassifications, opening balances, tax provisions, dividends). Money moved between two of the account's own bank accounts is a bank transfer, not a journal: use create_bank_transfer. Finalised (posted to the ledger) on create by default, like every other Beeswax journal. Pass status: \"draft\" to stage it for review instead (then finalise_manual_journal). Rules enforced by the API: two or more lines; each line has account_id (a chart-of-accounts transaction_account id) and exactly one of debit or credit as a positive number; total debits MUST equal total credits; every account must belong to this account. Requires a token with the journal_entries:write scope.",
    "inputSchema": {
      "properties": {
        "date": {
--- pinned/create_quote
+++ observed/create_quote
  {
-   "description": "Create a whole quote in one call — header, sections, and each section's lines. A realistic quote is several phases and dozens of lines, so build the entire structure in this single call rather than adding lines one at a time. PRICE THE LINES FROM THE CATALOGUE where you can: give a line a transaction_template_id (see list_products_services, create_product_service) and it inherits that product's rate, income account, tax and unit, and takes the product's colour on the quote's Gantt preview — which is what makes a long quote's chart readable, one colour per discipline. Sections (`groups`) are the phases of the quote and keep the order you give them; so do the lines within each section. LANDS AS A DRAFT unless you pass status:\"finalised\". Creating a quote never emails anyone — sending it to the client, and marking it accepted, stay human actions in the Beeswax UI. Rules enforced by the API: project_id and company_id are required and must belong to your account (a quote is reachable through its project, so it cannot be created without one); every line needs a transaction_account_id from your chart of accounts, unless it names a product that carries one; any tax_id or transaction_template_id must be yours too; quantity cannot be negative. Resolve ids first with list_companies, list_projects and list_transaction_accounts. `unit_amount` is the PER-UNIT price — the line total is unit_amount x quantity — and Beeswax works out the debit/credit side from the account's classification, so you never set debit or credit yourself. Requires a token with the quotes:write scope.",
+   "description": "Create a whole quote in one call — header, sections, and each section's lines. A realistic quote is several phases and dozens of lines, so build the entire structure in this single call rather than adding lines one at a time. PRICE THE LINES FROM THE CATALOGUE where you can: give a line a transaction_template_id (see list_products_services, create_product_service) and it inherits that product's rate, income account, tax and unit, and takes the product's colour on the quote's Gantt preview — which is what makes a long quote's chart readable, one colour per discipline. Sections (`groups`) are the phases of the quote and keep the order you give them; so do the lines within each section. LANDS FINALISED AND NUMBERED, as a quote made in the Beeswax web app does; pass status:\"draft\" to keep it back for review (then finalise_quote). A finalised quote stays editable until it is marked accepted. Creating a quote never emails anyone — sending it to the client, and marking it accepted, stay human actions in the Beeswax UI. Rules enforced by the API: project_id and company_id are required and must belong to your account (a quote is reachable through its project, so it cannot be created without one); every line needs a transaction_account_id from your chart of accounts, unless it names a product that carries one; any tax_id or transaction_template_id must be yours too; quantity cannot be negative. Resolve ids first with list_companies, list_projects and list_transaction_accounts. `unit_amount` is the PER-UNIT price — the line total is unit_amount x quantity — and Beeswax works out the debit/credit side from the account's classification, so you never set debit or credit yourself. Requires a token with the quotes:write scope.",
    "inputSchema": {
      "properties": {
        "company_id": {
-         "description": "Default 'draft'. 'finalised' moves it out of draft. Neither one sends anything to the client.",
+         "description": "Default 'finalised', as in the web app. 'draft' keeps it back for review. Neither one sends anything to the client.",
          "enum": [
            "draft",
            "finalised"

+ tool added: create_task

+ tool added: create_transaction_account

+ tool added: delete_bank_transfer

+ tool added: delete_manual_journal

+ tool added: delete_task_file

--- pinned/finalise_manual_journal
+++ observed/finalise_manual_journal
  {
-   "description": "Post a DRAFT manual journal to the ledger (draft -> finalised) and allocate its number. This is the deliberate, human-in-the-loop step that makes the entry real — only call it once the draft has been reviewed and confirmed. Requires journal_entries:write.",
+   "description": "Post a DRAFT manual journal to the ledger (draft -> finalised). Its number was issued when the draft was created and does not change. The same step is the Finalise button on the journal in Beeswax (Manual Journals lists every draft first). This is the deliberate, human-in-the-loop step that makes the entry real — only call it once the draft has been reviewed and confirmed. Requires journal_entries:write.",
    "inputSchema": {
      "properties": {
        "id": {
--- pinned/finalise_quote
+++ observed/finalise_quote
  {
-   "description": "Move a DRAFT quote to finalised. This is internal only — it does NOT email the quote to the client and does not mark it accepted; both of those stay human actions in the Beeswax UI. Call it once the draft has been reviewed. Requires quotes:write.",
+   "description": "Move a DRAFT quote to finalised. This is internal only — it does NOT email the quote to the client and does not mark it accepted; both of those stay human actions in the Beeswax UI. Only needed for a quote created with status:\"draft\" (quotes are finalised on create by default); call it once that draft has been reviewed. Requires quotes:write.",
    "inputSchema": {
      "properties": {
        "id": {
--- pinned/get_bank_statement_status
+++ observed/get_bank_statement_status
  {
-   "description": "Status of the latest statement PDF run on a statement check: idle, pending, extracting, matching, completed (with matched/unmatched counts), failed (with the error) or date_mismatch. Runs usually take under a minute. Requires reconciliations:read.",
+   "description": "Status of the latest statement PDF run on a bank reconciliation: idle, pending, extracting, matching, completed (with matched/unmatched counts), failed (with the error) or date_mismatch. Runs usually take under a minute. Requires reconciliations:read.",
    "inputSchema": {
      "properties": {
        "id": {

+ tool added: get_bank_transfer

+ tool added: get_bas_period

+ tool added: get_bas_period_transactions

+ tool added: get_help

+ tool added: get_task

--- pinned/get_tax_return
+++ observed/get_tax_return
  {
-   "description": "Get one tax return in full: every section with its fields, current values, the source of each value (auto / manual / calculated), whether each field is editable, and the calculated taxable income and tax. Read this before updating a field.",
+   "description": "Get one tax return in full: every section with its fields, current values, the source of each value (auto / manual / calculated), whether each field is editable, the calculated taxable income and tax, and its year's step 1 (year-end review) status with the red checks that stop it being finalised. Each calculated field carries its formula with the figures in it (e.g. \"S = T5 40,402.25 + G 0.00 − H 0.00 − I 0.00 − K 14,061.00 = 26,341.25\"); each editable field lists the totals it feeds, and a field that feeds none carries an effect_note naming the field that does. `warnings` lists figures that disagree (with each other, with the ATO's instalment amounts, or with the ATO's figure recorded after finalising). Each has `accepted`: an open one (accepted false) stops the return being finalised until the figures are corrected or a person accepts it with a reason on the web. Investigate each open warning, correct the field when the fix is clear, and otherwise report it to the user; accepting is theirs to do. Read this before updating a field, and enter a figure where its formula shows it is used. A company return carries `profile`: the business's yes/no answers (overseas dealings, trading stock, capital assets and so on), set by a person on the web. Fields and sections marked `hidden: true` (with a `hidden_reason`) are ones the profile, an ended incentive or rare use hides on the web page; they are still on the return and can still be updated, and a field holding a figure is never hidden (`profile_conflict` says when the profile would hide it).",
    "inputSchema": {
      "properties": {
        "id": {

+ tool added: get_tax_workflow_status

+ tool added: get_year_end_review

+ tool added: get_year_end_review_check

--- pinned/list_account_transactions
+++ observed/list_account_transactions
  {
-   "description": "The ledger for ONE transaction account over a period — the reconciliation query. Returns every POSTED posting to the account between from and to (inclusive, by document date), oldest first, with the opening balance at `from`, a running balance on each line, the period's debit and credit totals and the closing balance. Drafts, payroll templates, quotes and voided entries never appear, so these figures can be compared directly with a trial balance or a tax-return field. Balances follow the account's classification: asset/expense accounts grow with debits, income/loan/equity accounts with credits. Accrual basis only. Use list_transaction_accounts to find the account id. Requires transaction_accounts:read AND transactions:read.",
+   "description": "The ledger for ONE transaction account over a period — the reconciliation query. Returns every POSTED posting to the account between from and to (inclusive, by document date), oldest first, with the opening balance at `from`, a running balance on each line, the period's debit and credit totals and the closing balance. A busy account returns a very large result: pass summary:true for the totals alone (opening, debit, credit, closing, transaction_count), or page and per_page for one page at a time. Omit all three for every line. For every account's total at once use trial_balance, profit_and_loss or balance_sheet. Drafts, payroll templates, quotes and voided entries never appear, so these figures can be compared directly with a trial balance or a tax-return field. Balances follow the account's classification: asset/expense accounts grow with debits, income/loan/equity accounts with credits. Accrual basis only (by document date): for a BAS period's figures on its cash or accrual basis use get_bas_period. Use list_transaction_accounts to find the account id. Requires transaction_accounts:read AND transactions:read.",
    "inputSchema": {
      "properties": {
        "from": {
+       "page": {
+         "description": "Return this page only, starting at 1. Running balances carry across pages. meta.total_pages says how many there are.",
+         "type": "integer"
+       },
+       "per_page": {
+         "description": "Lines per page, at most 100 (default 25). Implies page 1 when page is omitted.",
+         "type": "integer"
+       },
+       "summary": {
+         "description": "true returns the totals only, with no lines: opening_balance, debit_total, credit_total, closing_balance and transaction_count.",
+         "type": "boolean"
+       },
        "to": {
          "description": "End date (inclusive), e.g. '2026-06-30'.",
          "type": "string"
--- pinned/list_bank_reconciliations
+++ observed/list_bank_reconciliations
  {
-   "description": "List bank reconciliations (statement checks): one per bank account per statement period, newest first, with the statement's opening/closing balances, what Beeswax has ticked (total_received, total_spent), the signed difference and a state: pending_statement (created from a PDF still being read), reconciled, balanced (difference zero but rows still unticked) or unreconciled. Use list_transaction_accounts (bank accounts only) to find bank_account_id. Requires reconciliations:read.",
+   "description": "List bank reconciliations: one per bank account per statement period, newest first, with the statement's opening/closing balances, what Beeswax has ticked (total_received, total_spent), the signed difference and a state: pending_statement (created from a PDF still being read), reconciled, balanced (difference zero but rows still unticked), double_counted (difference zero, but an entry ticked here is also ticked on another statement) or unreconciled. Use list_transaction_accounts (bank accounts only) to find bank_account_id. Requires reconciliations:read.",
    "inputSchema": {
      "properties": {
        "bank_account_id": {
+           "double_counted",
            "unreconciled"
          ],
          "type": "string"

+ tool added: list_bank_transfers

--- pinned/list_projects
+++ observed/list_projects
  {
-   "description": "List the account's active projects. Use this to resolve a project name to the project_id that create_quote and the other document tools need.",
+   "description": "List the account's active projects. Use this to resolve a project name to the project_id that create_quote and the other document tools need. The list includes the account's internal project (internal:true), where overhead expenses and general income go; an account may have no other project. A quote cannot go on it.",
    "inputSchema": {
      "properties": {
        "updated_since": {

+ tool added: list_tasks

--- pinned/list_tax_returns
+++ observed/list_tax_returns
  {
-   "description": "List the account's tax returns (most recent financial year first) with status and completion %. Australian accounts only.",
+   "description": "List the account's tax returns (most recent financial year first) with status and completion %, and each year's step 1 (year-end review) status as the Tax Returns page shows it, from the review's last run: 'not_checked_yet' means it hasn't run recently, not that it passed (get_year_end_review runs it). A year with no return is not listed: use get_tax_workflow_status for it. Australian accounts only.",
    "inputSchema": {
      "properties": {},
      "type": "object"

+ tool added: profit_and_loss

--- pinned/reconcile_bank_rows
+++ observed/reconcile_bank_rows
  {
-   "description": "Tick rows of a statement check as appearing on the bank statement. Pass remittance_ids and/or line_item_ids exactly as get_bank_reconciliation reports them. Ids that are not rows of this reconciliation come back under `unknown` and nothing is written for them. The response carries the updated rows and the reconciliation header (difference, state). Each tick is shown live to anyone viewing the page. Tick only rows you have matched to a statement line; if the statement does not show a transaction, leave it unticked and say so. Requires reconciliations:write.",
+   "description": "Tick rows of a bank reconciliation as appearing on the bank statement. Pass remittance_ids and/or line_item_ids exactly as get_bank_reconciliation reports them. Ids that are not rows of this reconciliation come back under `unknown` and nothing is written for them. A row whose entry is already ticked on another statement stays unticked and comes back under `ticked_elsewhere`: the statement line is a separate transaction, so find or record that one. The response carries the updated rows and the reconciliation header (difference, state). Each tick is shown live to anyone viewing the page. Tick only rows you have matched to a statement line; if the statement does not show a transaction, leave it unticked and say so. Requires reconciliations:write.",
    "inputSchema": {
      "properties": {
        "id": {

+ tool added: record_tax_return_expected_figure

+ tool added: search_help

+ tool added: trial_balance

--- pinned/unconfirm_tax_return_section
+++ observed/unconfirm_tax_return_section
  {
-   "description": "Unlock a previously-confirmed tax-return section for editing again. Requires a token with the tax_returns:write scope.",
+   "description": "Reopen a confirmed tax-return section so a person reviews and confirms it again. Confirming a section, finalising and unlocking a return are sign-offs the accountant or bookkeeper makes on the return in Beeswax; there is no tool for them, so when asked, say what is left for them to review. Requires a token with the tax_returns:write scope.",
    "inputSchema": {
      "properties": {
        "id": {
--- pinned/unreconcile_bank_rows
+++ observed/unreconcile_bank_rows
  {
-   "description": "Untick rows of a statement check (the inverse of reconcile_bank_rows, same arguments). Requires reconciliations:write.",
+   "description": "Untick rows of a bank reconciliation (the inverse of reconcile_bank_rows, same arguments). Requires reconciliations:write.",
    "inputSchema": {
      "properties": {
        "id": {
--- pinned/update_bank_reconciliation
+++ observed/update_bank_reconciliation
  {
-   "description": "Change a statement check's period or balances (e.g. the closing balance was mistyped). The page's table is re-broadcast. Requires reconciliations:write.",
+   "description": "Change a bank reconciliation's period or balances (e.g. the closing balance was mistyped). The page's table is re-broadcast. Requires reconciliations:write.",
    "inputSchema": {
      "properties": {
        "closing_balance": {
--- pinned/update_expense
+++ observed/update_expense
  {
-   "description": "Update a expense's HEADER — title, notes, date, supplier, supplier reference, project, tax settings. Sections and lines are untouched; use the section and line tools for those. Allowed while draft or finalised-unpaid; refused (422) once paid, part-paid, voided, or dated on or before the account lock date. Only the fields you pass change. Requires expenses:write.",
+   "description": "Update a expense's HEADER — title, notes, date, supplier, Supplier Invoice No, its note and stated amount, project, tax settings. Sections and lines are untouched; use the section and line tools for those. Allowed while draft or finalised-unpaid; refused (422) once paid, part-paid, voided, or dated on or before the account lock date — except that a paid or part-paid expense still accepts an update sending ONLY external_number, external_note and external_amount, and so does one in a lodged BAS period (the lock date still refuses it). Only the fields you pass change. Requires expenses:write.",
    "inputSchema": {
      "properties": {
        "company_id": {
+       "external_amount": {
+         "description": "The total the supplier's invoice states. The web page flags it when it differs from the bill's total. null clears it.",
+         "type": [
+           "number",
+           "null"
+         ]
+       },
+       "external_note": {
+         "description": "Note on the Supplier Invoice card. An AI receipt draft's note starts 'Auto-created from'; replacing it stops that draft being offered as a receipt for its bank line.",
+         "type": "string"
+       },
        "external_number": {
-         "description": "The supplier's own invoice number.",
+         "description": "Supplier Invoice No — the supplier's own invoice number.",
          "type": "string"
        },
        "id": {
--- pinned/update_invoice
+++ observed/update_invoice
  {
-   "description": "Update a invoice's HEADER — title, notes, date, client, project, tax settings. Sections and lines are untouched; use the section and line tools for those. Allowed while draft or finalised-unpaid; refused (422) once paid, part-paid, voided, or dated on or before the account lock date. Only the fields you pass change. Requires invoices:write.",
+   "description": "Update a invoice's HEADER — title, notes, date, client, purchase order number/note/amount, project, tax settings. Sections and lines are untouched; use the section and line tools for those. Allowed while draft or finalised-unpaid; refused (422) once paid, part-paid, voided, or dated on or before the account lock date — except that a paid or part-paid invoice still accepts an update sending ONLY external_number, external_note and external_amount, and so does one in a lodged BAS period (the lock date still refuses it). Only the fields you pass change. Requires invoices:write.",
    "inputSchema": {
      "properties": {
        "company_id": {
+       "external_amount": {
+         "description": "The amount the purchase order states. null clears it.",
+         "type": [
+           "number",
+           "null"
+         ]
+       },
+       "external_note": {
+         "description": "Note beside the purchase order number.",
+         "type": "string"
+       },
+       "external_number": {
+         "description": "The client's purchase order number.",
+         "type": "string"
+       },
        "id": {
          "type": "integer"
        },

+ tool added: update_task

--- pinned/update_tax_return_field
+++ observed/update_tax_return_field
  {
-   "description": "Set a manual override on one tax-return field — the same as a person editing it in the web form. Recomputes the totals. Pass an empty value to clear an override and revert to the auto-filled figure. Fails on calculated/read-only fields and on finalised or lodged returns. Requires a token with the tax_returns:write scope.",
+   "description": "Set a manual override on one tax-return field — the same as a person editing it in the web form. Recomputes the totals. Pass an empty value to clear an override and revert to the auto-filled figure. Fails on calculated/read-only fields and on finalised or lodged returns. The response's `effect` says what the change did: the totals the field feeds with their recalculated formulas, or — when it feeds none — that it changes no calculation and which field does. Check it: if a figure you entered changes nothing you expected to change, you have put it in the wrong field. `warnings` lists figures that now disagree. Requires a token with the tax_returns:write scope.",
    "inputSchema": {
      "properties": {
        "field_key": {

+ tool added: update_transaction_account

--- pinned/upload_bank_statement
+++ observed/upload_bank_statement
  {
-   "description": "Upload a bank statement PDF to an existing statement check and let Beeswax extract its lines and run its own matcher (exact, amount/date, then AI). Give file_path (a local PDF; this connector reads it) or base64. Poll get_bank_statement_status until completed, then get_bank_reconciliation shows the statement lines with their matches. PDF only, 25 MB. Requires reconciliations:write.",
+   "description": "Upload a bank statement PDF to an existing bank reconciliation and let Beeswax extract its lines and run its own matcher (exact, amount/date, then AI). Give file_path (a local PDF; this connector reads it) or base64. Poll get_bank_statement_status until completed, then get_bank_reconciliation shows the statement lines with their matches. PDF only, 25 MB. Requires reconciliations:write.",
    "inputSchema": {
      "properties": {
        "base64": {

tool removed: confirm_tax_return_section

tool removed: finalise_tax_return

tool removed: unfinalise_tax_return

Current tools

Show all 169 tool fingerprints
activate_theme
01e7304adb56aca8
add_expense_group
1bb8173ddf5fe81c
add_expense_line
f851f31a0bd3043e
add_invoice_group
e0c7714e638d3042
add_invoice_line
73fd07090cd16799
add_quote_group
735fc21eb2ef1382
add_quote_line
3fb8574c357ccbb5
add_tax_return_field_note
168234dbdd858e80
add_year_end_review_note
fb3485717498c291
apply_payment
1eaee251f7310c63
attach_expense_file
41caf6e9242d9f62
attach_invoice_file
4a4a48573b7258c0
attach_quote_file
9631f1e9537d6136
attach_task_file
d7277df89b3a7ffe
balance_sheet
6937102f26e26e42
block_agent_task
9e71008b300338a8
check_beeswax_connection
6557185b4e4ea3cc
claim_agent_task
7c462a1d9b8d8a8a
compare_tax_returns
db439fc0ea1d4b57
create_bank_reconciliation
184f0c95ff3dd5cb
create_bank_transfer
c597ba92f6a71df9
create_company
ded19e1937200fcb
create_expense
d7950f7a21cc2fcb
create_invoice
d421c14697472cd7
create_manual_journal
384887c4c58b2f95
create_product_service
85147c9b8dfedd66
create_project_document
904dfdd8ae721905
create_quote
eae7f1abe0809e0c
create_task
a708ea2667fa7253
create_tax_return
e8798f29ff5a2a9b
create_transaction_account
3615a36f5f202f81
delete_bank_transfer
6e410b356c587499
delete_expense
f5b14a3c6681d862
delete_expense_file
c682a0b7b7d295e6
delete_expense_group
0e23b1dca6542924
delete_expense_line
c567cd04ac09df31
delete_invoice
ec682ed319eeb458
delete_invoice_file
c6c3b2b21e1402e3
delete_invoice_group
ef731b4ba9bb09d4
delete_invoice_line
51f678dcfa4948dd
delete_manual_journal
a7c63753e436dfc0
delete_product_service
931e87643d6d1700
delete_quote
9eed93115f713c48
delete_quote_file
702a0e8b21f1fa6e
delete_quote_group
684dd16f18799a66
delete_quote_line
0231bd561627486c
delete_task_file
0455af703a959ed4
delete_theme
baa664d3924d4038
edit_tax_return_field_note
c02de98e582e87c9
finalise_expense
303a0e3f791f0eeb
finalise_invoice
e2373d6b21c73c9f
finalise_manual_journal
12934c8eb1787bf5
finalise_quote
e937bcd561bea3b9
find_possible_duplicate_payments
78f6fe427f07cb2c
get_agent_task
76d64abe7534224a
get_bank_reconciliation
1d22ab4ab53ed3cd
get_bank_statement_status
687add8eb631c38a
get_bank_transfer
f5cacbb40cbdfbad
get_bas_period
61dad960774da2fd
get_bas_period_transactions
0acfb468a04e61a4
get_company
3e2236d136af9c8b
get_event
2e54512ff7b0dc10
get_expense
c1a0c5e3461b7b9e
get_expense_version
b6ba7dfdeda724d3
get_help
e77542cb25b91f1b
get_invoice
59eede2f710c95b0
get_invoice_version
808b0192983d3c0a
get_journal_entry
5e8d78db0f9f8dec
get_manual_journal
84f8e2ad3fa02794
get_milestone
df82a5361d54f29d
get_payment
6a98324e3d362477
get_product_service
a05ab59bcd527526
get_project
638c54bc7c4033a4
get_project_document
c9c3a7a580c378bd
get_project_document_version
06ab97d3e427abb3
get_quote
6970eee75f1a01cb
get_task
282c0092e8993c3e
get_tax_return
a2c5b44d2b00aaf8
get_tax_return_conversation
07277186f5eb0034
get_tax_return_field_transactions
b051ea94ba5ebe6a
get_tax_workflow_status
92ff391bbba0fbba
get_theme
6129aeba61011a58
get_theme_spec
51e96a9b72239056
get_time_entry
fd457369851b062a
get_year_end_review
d88fa504c43ed586
get_year_end_review_check
44eb7a70657b3cd3
heartbeat_agent_task
7e71daddb983c2dc
list_account_transactions
4e2fbb2a1b1d7a4b
list_agent_tasks
44adf535edcdd4f3
list_bank_reconciliations
bc924b027d389441
list_bank_transfers
3fc1ea162acbd841
list_companies
8b40308aad912a6b
list_events
6923da2436190023
list_expense_files
737370301321c15d
list_expense_groups
cf28d3ed0c5815cd
list_expense_transactions
2a0d190a0ebbc05a
list_expense_versions
5bc01c642df84363
list_expenses
ae04e11927d774e7
list_invoice_files
75a36cb0667f4673
list_invoice_groups
2992c2409ae46889
list_invoice_transactions
d27789654ef8d767
list_invoice_versions
fac6d9677d50790e
list_invoices
2cc20229723b05c4
list_journal_entry_transactions
fe27d69e3c78dad2
list_manual_journals
46942b0a5b105965
list_milestones
c9077e982bd7d28a
list_payment_transactions
5d6dfa087f9c823e
list_products_services
4be25e9bebea2cd4
list_project_document_versions
3eb685801e51c39f
list_project_documents
5b6add8728d5ee7f
list_projects
1d6b8cd5261297c9
list_quote_files
a3333075edac01a9
list_quote_groups
6bfdbfa7e751ee4b
list_quote_transactions
1baedc2aa1a339c8
list_quotes
0a5238710a572f4e
list_task_file_versions
68045aa87be979a9
list_task_files
5011474db515de52
list_tasks
c024f21e9b8919e4
list_tax_return_field_notes
670b1994aa5681cd
list_tax_returns
cffbe4158b59ed75
list_taxes
bd46c01fffed5bf5
list_themes
17bd3a5c49e470f6
list_time_entries
bae270a1b89b8895
list_transaction_accounts
fb9b23c3885332fe
match_bank_statement_line
b819027058cc73e6
post_tax_return_message
f0920b10ac788c1b
preview_theme
a87782d38c9e20bc
profit_and_loss
6fccf038820b59a6
query_journal_entries
e532a79d10e764e3
query_payments
65ef4ad56653af8a
read_task_messages
de7987572a397772
reconcile_bank_rows
ae2d450ccf56385a
record_tax_return_expected_figure
950e35e858db228c
remove_payment
446623072814b87a
reorder_quote_groups
e00d5c211eed5978
reorder_quote_lines
d24dd7808d1104ec
repopulate_tax_return
78b92e1ec9c23a1f
restore_expense_version
7b7eb2a7bee5fc21
restore_invoice_version
2a42aa3644f083b4
restore_project_document_version
3e53c0283dee0227
search_help
ad68356b1b0a4834
send_task_message
265cf2e2db62c632
submit_agent_task
2320c57f72b259ce
tax_return_preflight_check
f6440d5728b079a2
trial_balance
8407348e26a312a0
unconfirm_tax_return_section
5fa72ef768e79369
unmatch_bank_statement_line
aa6a078a7019bb9e
unreconcile_bank_rows
584c2913a2d354b8
update_bank_reconciliation
0a08a86ee23ba361
update_company
315f3daefcac3c27
update_expense
52c3cd2e3ee02765
update_expense_group
535ca2d78bbef52c
update_expense_line
30ce0bc84966f95e
update_invoice
4705980402189bc4
update_invoice_group
943cb2ea1c54a685
update_invoice_line
74dd4e57c9ffabbd
update_product_service
153626639b9c5337
update_project_document
51ed132b57ccce41
update_quote
61a4bc82cb87a8bd
update_quote_group
59a2dd98d5bfaef9
update_quote_line
4f89cf817da62c09
update_task
5b49dd7170326bb0
update_tax_return_field
3b93040db02cf892
update_transaction_account
2e58a2931a058507
upload_bank_statement
304ef45f69669139
upsert_theme
a34fab7b4bd247d8
validate_theme
e423e836fd4d7d47
void_expense
d03a3bb087a081b8
void_invoice
33bf5b234df7c2a4

Watch this server yourself

If you run this server, put the proxy in front of it. It pins these exact fingerprints on first connect and stops the session if they move.

npx -y mcp-pin@0.2.4 -- <your beeswax-mcp command>

Or subscribe to this page's RSS feed to be told when it changes.

Badge

mcp-pin status badge for beeswax-mcp

The badge states one fact about time and nothing else. It never claims a server is safe.

[![mcp-pin](https://mcp-pin.gautamkhosla.com/badge/4f90df1beb3655d2.svg)](https://mcp-pin.gautamkhosla.com/servers/4f90df1beb3655d2.html)