Skip to main content
Glama

crunch-mcp

Talk to your books.

An open-source Model Context Protocol server for Crunch Accounting, the UK online accounting service. It lets Claude and other AI assistants read and, if you allow it, update your expenses, receipts, invoices, clients, suppliers and bank accounts, all from one small Docker container.

CI Release Container image License: MIT

crunch-mcp.mattoddie.dev

Quick start · Documentation · Tool reference · Contributing


"How's the business looking this month?" You have £18,240 across your two bank accounts and £312 on the company credit card. Three sales invoices are unpaid, £7,800 in total. INV-0042 to Example Client Ltd (£2,400) is 12 days overdue; the other two aren't due yet. On the spending side, four September expenses have no receipt attached and one bill from Example Hosting Ltd (£96) is still unpaid. Want me to draft a polite chaser for INV-0042, or list the expenses that are missing receipts?

Ask about your business in plain English. The assistant picks from 74 tools to look things up and, if you allow it, make changes. Some examples:

  • 🩺 "Give me a health check of the business."

  • 🧾 "Here's a receipt for a train ticket to Leeds. Record it as an expense paid from the business account."

  • 📬 "Which invoices are overdue? Draft a chasing email for each customer."

  • 📊 "Summarise income and spending for the last quarter, with an estimate of the VAT."

  • 🔍 "Which expenses this year have no receipt attached?"

  • 📝 "Invoice Example Client Ltd for 5 days of consulting at £450 a day, on 30-day terms."

Highlights

  • 🐳 Docker-first and tiny. One image (ghcr.io/mattoddie/crunch-mcp) for linux/amd64 and linux/arm64, about 21 MB. It's a single static Go binary on a distroless base, with no shell or package manager, running as a non-root user. It serves Streamable HTTP for a long-running service, or stdio for docker run -i. Each release also has plain binaries for macOS, Linux and Windows on amd64 and arm64.

  • 🛡️ Safe by default. The server is read-only unless you turn on writes. Deleting needs a second switch, and emailing invoices or payment reminders to customers needs a third. The switches also hold inside request bodies and the raw API tool, and the HTTP server requires a bearer token. Tools that aren't allowed aren't registered at all, and destructive tools, such as deletes and issuing an invoice, are labelled so your MCP client asks before running them.

  • 🔑 Least-privilege login. It logs in with Crunch's own OAuth 2.0 flow (with PKCE) and asks only for the scopes your settings need. Tokens never appear in tool output.

  • 🔄 Stays logged in. Crunch rotates refresh tokens, and reusing an old one revokes your login. crunch-mcp saves each new token before using it and never refreshes twice at once, so it keeps working across restarts.

  • ✏️ Careful updates. Changing an expense or invoice fetches the current record and changes only what you asked, so payments and attachments are never dropped by accident.

  • 🔍 Preview and audit. Every tool that changes something takes dry_run: true to show the request it would send, with a field-by-field diff for updates, without changing anything. CRUNCH_AUDIT_LOG records each change in a JSON Lines audit log.

  • 🖥️ One-click Claude Desktop install. Each release has an extension bundle (.mcpb) for macOS, Windows and Linux, with a settings form and no Docker needed.

  • 📎 Receipts and PDFs. Attach receipts and timesheets, download receipts as images the assistant can read, and fetch invoice PDFs.

  • 🎛️ Tunable. Expose only the toolsets you need, which keeps the model's context small and focused. List tools take search, fields and limit to fetch only what's needed.

  • 🧪 Tested. The test suite runs against a mock Crunch API and OAuth server on every build.

Related MCP server: @cynco/mcp

Quick start

Using Claude Desktop? Download the extension bundle for your computer from the latest release, open it, enter your Crunch client ID and ask Claude to "log in to Crunch". See Claude Desktop. The steps below set up the Docker server for every other client.

You need Docker, a Crunch account, Crunch API access and an MCP client such as Claude Code.

1. Get API access. Apply for access to Crunch's public API through the application form linked from Crunch's developer documentation. Crunch sends you a client ID, and a client secret if you're set up as a confidential client. There's no sandbox, so a free Crunch account is a good place to try things. Getting started has the details.

2. Set up the server.

mkdir crunch-mcp && cd crunch-mcp
curl -fsSLO https://raw.githubusercontent.com/mattoddie/crunch-mcp/main/compose.yaml
curl -fsSL https://raw.githubusercontent.com/mattoddie/crunch-mcp/main/example.env -o .env
# Edit .env: set CRUNCH_CLIENT_ID (and CRUNCH_CLIENT_SECRET if you have one)
# and a random MCP_AUTH_TOKEN, which the HTTP server requires (e.g. `openssl rand -hex 32`)

3. Log in to Crunch and start the server.

docker compose run --rm -p 127.0.0.1:8976:8976 crunch-mcp login   # open the URL it prints and click Allow
docker compose up -d

If your browser isn't on the Docker host, the page after Allow won't load. That's fine: copy the URL from the address bar and paste it into the terminal.

4. Connect your assistant.

claude mcp add --transport http crunch http://<docker-host>:8080/mcp \
  --header "Authorization: Bearer <MCP_AUTH_TOKEN>"

Now ask "How's my business doing?" in Claude Code.

Using Claude Desktop, VS Code, Cursor or Codex? See Connecting MCP clients. Prefer not to run a service? Use stdio mode with docker run -i, or a release binary without Docker. On macOS or Linux: brew install mattoddie/tap/crunch-mcp.

crunch-mcp is listed in the official MCP Registry as io.github.mattoddie/crunch-mcp, so clients that install servers from the registry can set it up for you, with the Docker image in stdio mode or an extension bundle.

Turning on changes

Out of the box the assistant can look but not touch. To let it make changes, add these to .env:

CRUNCH_ALLOW_WRITES=true    # create and update expenses, invoices, clients, suppliers, payments, attachments…
CRUNCH_ALLOW_DELETES=true   # also allow deleting records and removing payments (needs writes)
CRUNCH_ALLOW_EMAIL=true     # also allow emailing invoices and payment reminders to customers (needs writes)
CRUNCH_TOOLSETS=account,reference,expenses,invoices,clients,suppliers   # optional: expose fewer tools
CRUNCH_AUDIT_LOG=stderr     # optional: log every change (or an absolute file path; see docs/configuration.md)

The login needs matching scopes, so log in again after turning on writes or deletes:

docker compose stop
docker compose run --rm -p 127.0.0.1:8976:8976 crunch-mcp login
docker compose up -d

Ask for a dry run first when it matters: "Record that receipt, but show me a dry run first."

Read Security before turning on writes for your real books.

What it can do

Toolset

What's covered

account

Login status and the OAuth login flow, the logged-in user, company details (VAT number and scheme, addresses) and a one-call business overview

reference

The values Crunch expects: expense types, VAT types, payment methods, countries, open accounting periods, directors and employees

banking

Bank accounts and credit cards: balances, details, payments recorded against them, opening balances, default accounts, archiving

clients

Clients (the customers you invoice): list, look up, create, update and delete

suppliers

Suppliers: list, look up, create, update, archive and delete

expenses

Expenses: list and filter, totals, create with lines, payments and receipts, update, record and remove payments, attach and download receipts, delete

recurring

Recurring expenses that Crunch creates on a schedule: list, create, pause or change, delete

invoices

Sales invoices: list and filter, totals, create drafts, update, issue, email to the customer, record and remove payments, attachments, PDF download, delete

reports

Read-only reports built from your invoices and expenses: aged debtors and creditors, VAT summary by VAT type, credit notes

raw

An escape hatch that calls any Crunch public API endpoint. Off unless listed by name in CRUNCH_TOOLSETS (all leaves it out)

See the tool reference for every tool and argument. Ready-made prompts like business_health_check, record_receipt and chase_overdue_invoices chain the tools together for common jobs.

Documentation

The docs are also published at crunch-mcp.mattoddie.dev/docs, with search.

🚀 Getting started

Step-by-step setup, from API access to first question

🔌 Connecting MCP clients

Claude Code, Claude Desktop, VS Code, Cursor, Codex, stdio mode

⚙️ Configuration

Every environment variable, how login and tokens work, Docker secrets, toolsets

🐳 Deployment

Compose, image tags, upgrades, TLS reverse proxy, hardening, running without Docker

💬 Using crunch-mcp

Example conversations, prompts, how changes, receipts and PDFs work

🧰 Tool reference

Every tool and prompt, generated from the code

🛡️ Security

Threat model, least privilege, token storage, safe write setups

📡 Compatibility

The Crunch API, its limits, and known gaps

🩹 Troubleshooting

Common errors and how to fix them

🛠️ Development

Architecture, adding a tool, testing

Contributing

Contributions are very welcome, whether that's bug reports, docs or new tools. Read the contributing guide to get started, and please follow the code of conduct. To report a vulnerability, see the security policy. Please don't open a public issue for one.

License

MIT © Matt Oddie

crunch-mcp is an independent community project. It is not affiliated with, endorsed by or sponsored by Crunch (E-Crunch Ltd). "Crunch" is a trademark of E-Crunch Ltd.

Available Tools

63 tools
crunch_add_expense_attachmentAttach receipt to expenseB

Attach one or more files (receipts, invoices) to an existing expense. Existing attachments are kept.

Inputs: expense_id (required), attachments (required), dry_run.

crunch_add_expense_paymentRecord expense paymentA

Record that an expense was paid (fully or partly): date, amount, payment method and the bank account, credit card or director it was paid from. Existing payments are kept.

Inputs: date (required), amount (required), expense_id (required), dry_run, +4 more.

crunch_add_invoice_attachmentAttach file to invoiceA

Attach files (for example timesheets) to a sales invoice. Existing attachments are kept; an invoice can have up to 5.

Inputs: invoice_id (required), attachments (required), dry_run.

crunch_add_invoice_paymentRecord invoice paymentA

Record a payment received from a customer against an issued invoice (full or part payment). This records the payment but doesn't reconcile the matching bank statement entry. Existing payments are kept.

Inputs: date (required), amount (required), invoice_id (required), dry_run, +2 more.

crunch_archive_bank_accountArchive or restore bank accountA
Idempotent

Archive a bank account you no longer use (it stays in your records but is hidden), or restore an archived one with archive=false.

Inputs: bank_account_id (required), archive, dry_run.

crunch_archive_credit_cardArchive or restore credit cardA
Idempotent

Archive a credit card you no longer use, or restore an archived one with archive=false.

Inputs: credit_card_id (required), archive, dry_run.

crunch_auth_completeFinish Crunch loginA

Finish a login started with crunch_auth_start by exchanging the authorisation code for tokens, which are saved to the token file. Pass the full URL the browser was redirected to, or just the code together with the state crunch_auth_start returned.

Inputs: redirected_url (required), state.

crunch_auth_startStart Crunch loginA

Start logging this server in to a Crunch account (OAuth 2.0 with PKCE). Returns a URL for the user to open and approve. After they click Allow, the browser is sent to the redirect URI; if nothing is listening there the page fails to load, which is fine: ask the user to copy the full URL from the address bar and pass it to crunch_auth_complete. Logging in replaces the current tokens, possibly with a different Crunch account.

crunch_auth_statusCrunch login statusA
Read-only

Show whether this server is logged in to Crunch: where the tokens come from, the granted scopes, when the access token expires and whether a refresh token is available. Never shows the tokens themselves.

crunch_create_bank_accountCreate bank accountB

Add a bank account to Crunch so payments can be recorded against it.

Inputs: bank_name (required), display_name (required), bic, iban, +6 more.

crunch_create_clientCreate clientA

Create a client (customer) to invoice. A name and a billing address with line1, line2 and country are needed. Check crunch_list_clients first to avoid duplicates.

Inputs: name (required), billing_address (required), note, email, +3 more.

crunch_create_credit_cardCreate credit cardA

Add a credit card to Crunch so expenses can be paid from it. Set its opening balance with crunch_set_credit_card_opening_balance.

Inputs: display_name (required), extra, dry_run, personal, +1 more.

crunch_create_expenseCreate expenseA

Record an expense: who it was from, the date, one or more lines (expense type, VAT type, gross amount), and optionally how it was paid and the receipt. Look up valid values first: crunch_list_expense_types, crunch_list_vat_types, crunch_list_payment_methods, crunch_list_bank_accounts. The date must be in an open accounting period. Refuses an expense that matches an existing one (same supplier, date, gross amount and supplier reference) unless allow_duplicate=true.

Inputs: line_items (required), posting_date (required), note, extra, +8 more.

crunch_create_invoiceCreate invoiceA

Create a draft sales invoice for a client: date, lines (description, unit price excluding VAT, quantity, VAT rate), payment terms and the bank account to be paid into. Crunch's API only supports GBP. The invoice stays a draft until crunch_issue_invoice. Look up the client (crunch_list_clients), VAT rates (crunch_list_vat_types for=invoices) and bank account first.

Inputs: items (required), client_id (required), issued_date (required), note, +10 more.

crunch_create_recurring_expenseCreate recurring expenseA

Set up a recurring expense: a template expense (supplier, lines, optional payment method) that Crunch creates automatically on a schedule. Schedule values are Crunch's own; look at an existing one with crunch_get_recurring_expense if you're unsure of the names.

Inputs: line_items (required), recurrence (required), note, extra, +8 more.

crunch_create_supplierCreate supplierA

Create a supplier. Only company_name is required; a default expense_type makes new expenses for this supplier quicker. Check crunch_list_suppliers first to avoid duplicates.

Inputs: company_name (required), extra, country, dry_run, +3 more.

crunch_download_expense_attachmentDownload expense attachmentA
Read-only

Download a receipt or other file attached to an expense. Images are returned so you can read them; other files (PDFs) come back as an embedded resource. Attachment IDs and names come from crunch_get_expense.

Inputs: expense_id (required), attachment_id (required), save_to, file_name.

crunch_download_invoice_attachmentDownload invoice attachmentA
Read-only

Download a file attached to a sales invoice. Attachment IDs and names come from crunch_get_invoice.

Inputs: invoice_id (required), attachment_id (required), save_to, file_name.

crunch_download_invoice_pdfDownload invoice PDFA
Read-only

Download a sales invoice as a PDF, as Crunch renders it for the customer. Returned as an embedded resource; use save_to to also write it to disk (when the server sets CRUNCH_FILES_DIR).

Inputs: invoice_id (required), save_to.

crunch_get_aged_creditorsAged creditorsA
Read-only

What the business owes suppliers and for how long: the outstanding balance of every unpaid or part-paid expense, grouped by age (0-30, 31-60, 61-90 and over 90 days since the expense date, since Crunch's expenses have no due date) and by supplier, largest first. Reads every expense up to the report date, so it can take a few seconds on a large account. details=true also lists each expense.

Inputs: details, as_of_date.

crunch_get_aged_debtorsAged debtorsA
Read-only

Who owes the business money and for how long: the outstanding balance of every issued sales invoice, grouped by days past its due date (current, 1-30, 31-60, 61-90 and over 90 days) and by customer, largest first. Drafts are left out. Reads every invoice, so it can take a few seconds on a large account. details=true also lists each invoice.

Inputs: details, as_of_date.

crunch_get_bank_accountGet bank accountA
Read-only

Get one bank account in full: balance, account details, bank feed, unmatched statement entries and whether it can be edited, archived or deleted.

Inputs: bank_account_id (required).

crunch_get_clientGet clientA
Read-only

Get a client (customer) in full: contact details, billing address, payment terms and note.

Inputs: client_id (required).

crunch_get_company_detailsGet company detailsB
Read-only

Get the business's details from Crunch: company name and number, VAT registration number, current VAT scheme (for example flat rate, with industry and limited cost trader status), and business and registered addresses.

Inputs: raw.

crunch_get_credit_cardGet credit cardA
Read-only

Get one credit card in full, including its opening balance.

Inputs: credit_card_id (required).

crunch_get_default_invoice_noteGet default invoice noteA
Read-only

Get the default note Crunch prints on new sales invoices (often payment instructions).

crunch_get_expenseGet expenseA
Read-only

Get one expense: its lines (types, VAT, amounts), payments, attachments, credit notes, and whether it can still be edited or deleted. raw=true returns the API object.

Inputs: expense_id (required), raw.

crunch_get_expenses_totalGet expenses totalA
Read-only

Total the expenses matching the filters (gross amount, plus under- and over-paid amounts) without listing them. Handy for "how much did I spend on travel this year?".

Inputs: status (required), end_date, start_date, supplier_id, +5 more.

crunch_get_invoiceGet invoiceA
Read-only

Get one sales invoice: customer, dates, lines, VAT, payments received, credit notes, attachments and status. raw=true returns the API object.

Inputs: invoice_id (required), raw.

crunch_get_invoice_statusGet invoice statusA
Read-only

Get an invoice's current state (status, number, amounts, outstanding balance, due date), which is lighter than crunch_get_invoice.

Inputs: invoice_id (required).

crunch_get_invoice_totalsGet invoice totalsA
Read-only

Get sales invoice totals: with no filters, everything invoiced and still outstanding; with filters (client, status, issue or due dates, invoice number, recurring), the amount invoiced, owed to you and owed by you for the matching invoices.

Inputs: status, client_id, recurring, due_to_date, +4 more.

crunch_get_opening_balancesGet opening balancesB
Read-only

Get the opening balances of bank accounts or credit cards, and whether each can still be edited.

Inputs: account_ids (required), type.

crunch_get_overviewBusiness overviewA
Read-only

A one-call snapshot of the business: company and VAT details, bank account and credit card balances, sales invoice totals (invoiced and outstanding) and open accounting periods. A good first call for questions like "how is my business doing?".

crunch_get_recurring_expenseGet recurring expenseA
Read-only

Get a recurring expense in full: the template expense (supplier, lines, payment) and its schedule (recurringEvent).

Inputs: recurring_expense_id (required).

crunch_get_supplierGet supplierC
Read-only

Get a supplier in full.

Inputs: supplier_id (required).

crunch_get_user_detailsGet user detailsA
Read-only

Get the logged-in Crunch user: ID, email address, first and last name.

crunch_get_vat_summaryVAT summaryA
Read-only

Net, VAT and gross by VAT type for a period, for sales (issued invoices by issue date) and purchases (expenses by expense date), with VAT on sales minus VAT on purchases. Use it to sense-check a VAT return; it is not one (Crunch's API has no VAT returns, and the Flat Rate Scheme and cash accounting work VAT out differently). Reads each invoice in the period, so long periods take a while.

Inputs: end_date (required), start_date (required).

crunch_issue_invoiceIssue invoiceA
Destructive

Issue a draft sales invoice: it gets its invoice number and is posted to your accounts. This is final (correct mistakes afterwards with a credit note in Crunch). It does not email the customer; see crunch_email_invoice.

Inputs: invoice_id (required), dry_run.

crunch_list_accounting_periodsList open accounting periodsA
Read-only

List the open accounting periods (financial years) with their start and end dates and status. Expenses can only be created or changed in an open period; closed years can't be edited.

Inputs: limit, fields, search.

crunch_list_bank_account_paymentsList bank account paymentsA
Read-only

List payments recorded in Crunch against a bank account (supplier payments, customer payments, transfers, salaries, dividends, tax payments...), either reconciled with the bank statement or still unreconciled. Paged; newest first by default.

Inputs: reconciled (required), bank_account_id (required), all, raw, +7 more.

crunch_list_bank_accountsList bank accountsA
Read-only

List the business's bank accounts with their current balance, sort code and account number, default flag, bank feed state and how many statement entries still need matching. Use the IDs when recording payments.

Inputs: raw, limit, fields, search, +1 more.

crunch_list_clientsList clientsA
Read-only

List the business's clients (the customers you invoice) with email, payment terms and billing address. Use the IDs as the customer on invoices.

Inputs: raw, limit, fields, search.

crunch_list_countriesList countriesA
Read-only

List the countries Crunch knows, with the country codes to use in addresses and supplier records, and whether each is an EU member.

Inputs: limit, fields, search.

crunch_list_credit_cardsList credit cardsA
Read-only

List the business's credit cards with their balances, default flag and unmatched statement entries.

Inputs: raw, limit, fields, search, +1 more.

crunch_list_credit_notesList credit notesA
Read-only

List credit notes: those issued against your sales invoices (for=invoices, the default), those from suppliers against expenses (for=expenses), or both (for=all), newest first, with the invoice or expense they belong to, amount, state and refunds. Crunch's public API can't create credit notes; do that in the Crunch app. Reads the invoices that have credits one by one, so it can take a few seconds.

Inputs: for, limit, fields, search, +2 more.

crunch_list_expensesList expensesA
Read-only

List expenses (purchases, receipts and bills), newest first, filtered by supplier, expense type, date, payment date, payment method or whether a receipt is attached. Each result shows supplier, amounts, status, outstanding balance and payment method. Paged (up to 200 per page); use all=true to fetch every page.

Inputs: all, raw, page, size, +13 more.

crunch_list_expense_typesList expense typesA
Read-only

List the expense types (categories) Crunch accepts in expenseType fields, for example ACCOUNTANCY, TELEPHONE or TRAVEL_AND_SUBSISTENCE, grouped as in Crunch, with each type's default VAT type. Use the name values when creating expenses and suppliers.

Inputs: raw, date, limit, fields, +2 more.

crunch_list_invoicesList invoicesA
Read-only

List sales invoices, newest first: number, customer, dates, status, amounts and outstanding balance. Filter by client, or by status (which fetches every page and filters here). Paged (up to 200 per page); use all=true to fetch every page.

Inputs: all, raw, page, size, +7 more.

crunch_list_payment_methodsList payment methodsA
Read-only

List payment methods (for example EFT, CASH, DIRECTORS_EXPENSES) for recording expense payments or invoice payments. Use name as the payment method.

Inputs: for, limit, fields, search, +1 more.

crunch_list_personsList directors and employeesA
Read-only

List the people (directors and employees) linked to the business on a date. Use their IDs as the person for DIRECTORS_EXPENSES payments and as the employee on expense lines.

Inputs: date, role, limit, fields, +1 more.

crunch_list_recurring_expensesList recurring expensesA
Read-only

List recurring expenses (regular bills such as rent, phone or software subscriptions that Crunch creates automatically) with supplier, amount, status and next date.

Inputs: all, raw, page, size, +5 more.

crunch_list_suppliersList suppliersA
Read-only

List suppliers (who you buy from), with their default expense type, country and VAT number. name asks Crunch for an exact company name. Use the IDs when creating expenses.

Inputs: raw, name, limit, fields, +2 more.

crunch_list_vat_typesList VAT typesA
Read-only

List the VAT types (rates) Crunch accepts, with their percentages. Expenses and invoices have separate lists; use the names exactly as shown (for example "Standard", "Exempt", "Outside the Scope"), not code-style values.

Inputs: for.

crunch_set_credit_card_opening_balanceSet credit card opening balanceA
Idempotent

Set a credit card's opening balance (the amount owed when you started using Crunch for it). Creates it, or updates an existing editable one.

Inputs: credit_card_id (required), opening_balance (required), dry_run.

crunch_set_default_bank_accountSet default bank accountA
Idempotent

Make a bank account the default one, used for new invoices and payments.

Inputs: bank_account_id (required), dry_run.

crunch_set_default_credit_cardSet default credit cardC
Idempotent

Make a credit card the default one.

Inputs: credit_card_id (required), dry_run.

crunch_update_bank_accountUpdate bank accountA
Idempotent

Change a bank account's details. Only the fields you pass change; the rest are kept. Sort code and account number can't be changed once the account has a bank feed or reconciled entries.

Inputs: bank_account_id (required), bic, iban, extra, +7 more.

crunch_update_clientUpdate clientA
Idempotent

Change a client's details. Only the fields you pass change; the rest are kept (a new billing_address replaces the whole address).

Inputs: client_id (required), name, note, email, +4 more.

crunch_update_credit_cardUpdate credit cardB
Idempotent

Change a credit card's details. Only the fields you pass change.

Inputs: credit_card_id (required), extra, dry_run, personal, +2 more.

crunch_update_expenseUpdate expenseA
Idempotent

Change an expense. The current expense is fetched and only what you pass changes: posting_date, supplier, reference, note, or line_items (which replace all lines). Payments and attachments are kept as they are; use crunch_add_expense_payment, crunch_remove_expense_payment and crunch_add_expense_attachment for those. Reconciled expenses and closed years can't be changed.

Inputs: expense_id (required), note, changes, dry_run, +4 more.

crunch_update_invoiceUpdate invoiceA
Idempotent

Change a sales invoice. The current invoice is fetched and only what you pass changes; existing payments and attachments are kept. items replaces all lines. Issued invoices may be restricted by Crunch.

Inputs: invoice_id (required), note, items, changes, +9 more.

crunch_update_recurring_expenseUpdate recurring expenseA
Idempotent

Change a recurring expense: its lines, its schedule (for example pause it with enabled=false, or change the next or end date), or any field via changes. Only what you pass changes. Expenses already created aren't affected.

Inputs: recurring_expense_id (required), note, changes, dry_run, +5 more.

crunch_update_supplierUpdate supplierA
Idempotent

Change a supplier's details, or archive/restore it. Only the fields you pass change.

Inputs: supplier_id (required), extra, country, dry_run, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 63 tools

    Disambiguation4/5

    Most tools target a clearly distinct resource and action, and descriptions help separate subtle pairs such as get_invoice/get_invoice_status/get_invoice_totals and list_expenses/get_expenses_total. Some reporting and totals tools overlap, and the large surface raises misselection risk, but not severely.

    Naming Consistency4/5

    Nearly all tools follow a predictable crunch_verb_noun snake_case pattern, such as crunch_list_clients, crunch_create_invoice and crunch_update_expense. The auth trio (crunch_auth_start/status/complete) uses noun_verb instead, which is a minor deviation.

    Tool Count2/5

    At 63 tools, the server is far above the typical 3-15 range and presents a heavy tool-selection surface. The breadth is partly justified by accounting CRUD across clients, suppliers, invoices, expenses, banks, cards, recurring items and reports, but it is still excessive.

    Completeness4/5

    Core accounting workflows—clients, suppliers, invoices, expenses, payments, attachments, bank and credit-card management, and key reports—are well covered. However, crunch_issue_invoice references a missing crunch_email_invoice tool, and there is no reconciliation operation or delete path for some resources, leaving minor dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to interact with QuickFile UK accounting software, providing access to invoicing, client management, purchases, banking, and financial reporting through 40+ tools covering the complete QuickFile API.
      17 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to read and write Cynco accounting data, including querying books, creating invoices, reconciling transactions, and generating financial reports.
      8 npm
      1
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Enables Claude to manage FreeAgent accounting tasks such as listing bank transactions, explaining and approving them with receipts, creating expenses, and logging mileage.
      28
      80 npm
      1
      MIT