io.github.theluckystrikePublished by GitHub account theluckystrikev0.23.0Updated Nov 3, 2026
Credit notes against issued invoices and purchase orders to suppliers, with VAT and A4 PDFs.
McpStamp Credit Notes and Purchase Orders's hosted MCP server (mcp.zovo.one); no sign-in required; Streamable HTTP; 16 tools.
No AI overview yet: these facts come from the registry entry and the server itself.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.theluckystrike%2Fbilling-docs-credit-notes-purchase-orders/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"mcpstamp-credit-notes-and-purchase-order": {
"type": "http",
"url": "https://mcp.zovo.one/mcp/billing-docs"
}
}
}Credit notes and purchase orders, on the same engine as your invoices.
When a client sends work back, or you billed them twice, you owe them a credit note: a document that
names the invoice it reverses and takes the money off it, with the VAT unwound at the rate you
charged. When you order from a supplier, you owe them a purchase order: what you want, at what price,
by when, with your own details on it. This server writes both, against the invoices and the clients
the mcp-invoice server already holds, and it will not let a credit note give back more money than
the invoice charged. Sending the same document twice is refused by the id of the one already there,
and a document nothing depends on can be deleted, so a re-send never costs you a free-tier slot.
Everything stays on your machine.
Built on @theluckystrike/mcp-invoice/lib: the money, VAT, currency and formatting code is the
invoice server's, not a second copy of it, so a credit note and the invoice it reverses agree to the
minor unit.
In the official MCP Registry (io.github.theluckystrike/billing-docs-credit-notes-purchase-orders).
npm publish for @theluckystrike/mcp-billing-docs is pending, so npx -y @theluckystrike/mcp-billing-docs returns 404 today. Until then, the .mcpb one-click bundle or a clone+build is the working path.
Claude Desktop (claude_desktop_config.json):
Claude Code:
Cursor (.cursor/mcp.json):
Run mcp-invoice alongside it: this server reads that server's invoices and clients, and both take
their name, address, VAT id and default currency from one shared business profile.
One resource, billing-docs://open-orders, and one prompt, chase_deliveries.
Get Pro: https://mcp.zovo.one/buy/billing-docs ($19 one-time for this server, $39 for the bundle).
Crediting part of a mixed-VAT invoice at one rate is wrong by more than the rounding you would expect. An invoice of EUR 1,000.00 consulting at 23% plus EUR 500.00 print at 8% totals EUR 1,770.00. Credit ten percent of it, EUR 177.00, the way a single-rate credit note would: net EUR 143.90, VAT EUR 33.10. This server splits the credit across the rates the invoice actually used, in proportion to each rate's share of the total, and gets net EUR 150.00 with VAT of EUR 23.00 at 23% and EUR 4.00 at 8%, EUR 27.00 in all. The gross the client sees is identical either way. The VAT line differs by EUR 6.10, 22.6 percent of it, and that is the number that goes on a VAT return.
Asserted in test/unit.test.mjs, "a credit note by amount splits the gross across the invoice's VAT
rates and reuses each rate".
All data stays local: ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/billing-docs/. No account, no API
key, no network call, ever. Licence keys are verified offline.
Built by theluckystrike. Support: [email protected]
Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:
Source: servers/billing-docs/README.md at commit 6535b33
Credit an invoice
Credit one invoice: the whole invoice, a GROSS amount_minor split over its VAT rates, or named lines. Amounts store negative, reusing the invoice's own rates. Free: 5 a month. Send it with credit_note_text.
linesnotesreasonrequiredinvoicerequiredissue_dateamount_minorList credit notes
List credit notes newest first: id, invoice, client, basis, reason, currency and the NEGATIVE total, with the amount credited per currency. Filter by invoice, client or issue date range.
tofromclientinvoiceShow one credit note
Return one credit note in full by id or exact client name: every negated line, VAT lines, totals, the reason, and the invoice number and date it reverses. Reads only. Use credit_note_list for the ids.
idrequiredRender the credit note as a PDF
Call this tool to render one credit note as an A4 print-ready document and return a download link valid for one hour: the invoice layout titled CREDIT NOTE, with the invoice it reverses. Pro.
idrequiredout_pathPlain-text credit note to paste into email
Turn a credit note into a plain-text summary to paste into an email: the negated line table, VAT lines, total, reason, and what now comes off the invoice. Also a .txt download link valid one hour. Free; credit_note_pdf writes the A4 document.
idrequiredgreetingsign_offDelete a credit note
Remove one credit note never posted to its invoice and never rendered, freeing that month's slot; the invoice becomes creditable again. One with a dependent is refused: issue a fresh note to reverse a sent one.
idrequiredRaise a purchase order
Raise a purchase order to a supplier from items and return its PO number and totals. unit_price is in MAJOR units; currency, VAT and the buyer block come from the shared profile. Free: 5 documents a calendar month.
itemsrequirednotescurrencysupplierrequiredtax_rateissue_datesupplier_emailsupplier_vat_iddiscount_percentsupplier_addressexpected_delivery_dateList purchase orders
List purchase orders newest first: id, supplier, order and expected delivery dates, status open, partially_received or received, currency, total and received date. Filter by status, supplier or date range.
tofromstatussupplierShow one purchase order
Return one purchase order in full by id or exact supplier name: buyer and supplier blocks, every line with unit price and VAT, totals, the delivery date, status and every receipt with its date and note.
idrequiredRender the purchase order as a PDF
Call this tool to render one purchase order as an A4 print-ready document and return a download link valid for one hour: the invoice layout titled PURCHASE ORDER, with the buyer and supplier. Pro.
idrequiredout_pathPlain-text purchase order to paste into email
Turn a purchase order into a plain-text order to paste into an email: the line table, VAT lines, total, and a line asking the supplier to deliver by the date and quote the PO number. Also a .txt download link valid one hour. Free on every tier.
idrequiredgreetingsign_offMark a purchase order received
Record that an order arrived. partial keeps it open and can be repeated, each receipt kept with its date and note; a full receipt closes it. An order already received, or a date before the order date, is refused.
idrequireddatenotepartialDelete a purchase order
Remove one purchase order with nothing received and never rendered, freeing that month's slot. One with a receipt is refused, naming it. The PO number is never reissued. purchase_order_receive logs arrivals.
idrequiredCredited money and open orders
Over a date range: what was credited back per currency and against how many invoices, what is still on order per currency, and every open order past its delivery date with days late. Pro; the list tools are free.
tofromLicense status
Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
Takes no parameters.
Activate license
Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
keyrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
{ "mcpServers": { "billing-docs": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-billing-docs"] } }}claude mcp add billing-docs -- npx -y @theluckystrike/mcp-billing-docs{ "mcpServers": { "billing-docs": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-billing-docs"] } }}