# Supplier Invoice Tool

> Supplier Invoice Tool is a free MCP server for finance and payments. Turns UK trade supplier invoices into draft Xero bills, one line per job. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://supplier-invoice-tool.nerolabs.workers.dev/docs
- **Repository:** https://github.com/nero-engine/supplier-invoice-tool-mcp
- **MCP Registry name:** io.github.Nero-Engine/supplier-invoice-tool
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Built for UK trade businesses such as electricians, it takes the invoices that arrive from merchants like CEF, Edmundson, Screwfix and Toolstation and groups them into a single draft bill per supplier per month. Each bill carries one line per job, so material costs land on the right job without manual retyping.

Invoices can be added as raw emails with PDF attachments, text or scanned PDFs, photos or pasted text, up to 25 per call. Invoices that cannot be read confidently are held back for checking, lines with no job reference can be assigned to a job by hand, and price rises on the same product code from the same supplier are flagged with the extra cost they caused.

Bills only ever go into Xero as drafts, with the original invoices attached, and the business approves them in Xero. The tool pays, approves and emails nothing. It is a remote server in test mode: each business gets a private key from its first call, and only a Xero Demo Company can be connected until the Xero link is approved. Claude.ai and ChatGPT custom connectors cannot send the key header yet, so it works from clients such as Claude Code, Cursor, VS Code and Windsurf.

## Features

- **Draft bill per supplier:** Groups a month of invoices into one draft Xero bill per supplier, with a line per job.
- **Flexible invoice intake:** Accepts emails with PDFs, text or scanned PDFs, photos and pasted text, up to 25 per call.
- **Price rise alerts:** Flags price changes on the same product code from the same supplier and the extra cost they caused.
- **Hold and review:** Holds unclear invoices for checking so you can accept or remove them before billing.
- **Job assignment:** Puts an invoice, or some of its lines, on a job when the reference is missing or wrong.
- **Originals kept:** Attaches the original invoices to the Xero drafts and gives private links to each one.

## Good for

- Turn a month of CEF and Screwfix emails into Xero draft bills
- Allocate merchant materials to jobs for job costing
- Spot supplier price increases on regularly bought products
- Check which invoices need a second look before bookkeeping

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http supplier-invoice-tool https://supplier-invoice-tool.nerolabs.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://supplier-invoice-tool.nerolabs.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "supplier-invoice-tool": {
      "url": "https://supplier-invoice-tool.nerolabs.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "supplier-invoice-tool": {
      "type": "http",
      "url": "https://supplier-invoice-tool.nerolabs.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "supplier-invoice-tool": {
      "serverUrl": "https://supplier-invoice-tool.nerolabs.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "supplier-invoice-tool": {
      "type": "http",
      "url": "https://supplier-invoice-tool.nerolabs.workers.dev/mcp"
    }
  }
}
```

## Tools

- `create_trade_account`: Start here, once per business. Creates the trade's invoice book and returns an API key to send as "Authorization: Bearer <key>" on every other call. Test mode: free, nothing is charged. The same identity (company number) can later sign the trade into Nero Work without a new sign up.
- `get_account`: The trade's account, settings and Nero identity.
- `update_settings`: Change how job references are read and how bills are entered in Xero.
- `add_supplier_invoices`: Add supplier invoices to the book: raw emails with PDF attachments, PDFs (text or scanned), photos, or pasted text, up to 25 per call. Each is read, checked against its own printed total, given its job reference, kept with its original, and checked for price changes against earlier invoices from the same supplier. Duplicates are skipped. Returns one result per document: added, needs_check (did not
- `month_summary`: The month at a glance: one draft bill per supplier with a line per job (net, VAT and which invoices), invoices held back to check, lines with no job reference, and price changes with the extra cost they caused. Includes the exact Xero payloads. Sends nothing.
- `list_invoices`: Every invoice in the book for a month, with its lines, status and any problems.
- `price_alerts`: Price changes on the same product code from the same supplier this month, in date order, and the extra they cost.
- `get_original`: A private link to the original email, PDF or scan of one invoice, to show the trade.
- `assign_job_reference`: Put an invoice (or some of its lines) on a job, when the supplier left the reference off or it was wrong.
- `review_invoice`: For an invoice held back as needs_check: accept it as read (it then goes on the bill), or remove it (for example to add a corrected copy). Ask the trade first.
- `connect_xero`: A link for the trade to open and sign in to Xero. Test mode: only a Xero Demo Company can be connected.
- `xero_status`: Whether Xero is connected, and to which organisation.
- `push_bills_to_xero`: Put the month's bills into Xero as DRAFT bills, one per supplier, one line per job, with the original invoices attached. Without send: true it is a dry run that shows what would be sent. Running it again updates the same draft (no duplicates). A bill the trade has already approved is never changed; late invoices go on a top up bill. Never approves or pays.
- `disconnect_xero`: Forget the Xero connection. Nothing in Xero is changed.

## FAQ

### Does it approve or pay bills in Xero?

No. Bills are created only as drafts and the business approves them in Xero; nothing is paid, approved or emailed.

### Does it work in Claude.ai or ChatGPT?

Not yet. Their custom connectors cannot send the fixed key header it needs, and a compatible sign-in is planned.

### How does authentication work?

The first call, create_trade_account, returns a private key once; later calls send it as an Authorization Bearer header.

### What does it cost?

It is free while in test mode, with no card or paid plan. Only a Xero Demo Company can be connected for now.

### Is Supplier Invoice Tool free?

Yes. Supplier Invoice Tool is free to use.

### How do I add Supplier Invoice Tool to Claude Code?

Run this command in your terminal: claude mcp add --transport http supplier-invoice-tool https://supplier-invoice-tool.nerolabs.workers.dev/mcp

### What are the best alternatives to Supplier Invoice Tool?

The closest alternatives to Supplier Invoice Tool are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/supplier-invoice-tool
