io.github.theluckystrike由 GitHub 账号 theluckystrike 发布v0.23.0更新于 Nov 3, 2026
针对已开具发票和供应商采购订单的贷项通知单，含增值税及A4 PDF。
AI 翻译由 AI 模型根据下方的原文描述翻译，可能有误。
Credit notes against issued invoices and purchase orders to suppliers, with VAT and A4 PDFs.
McpStamp Credit Notes and Purchase Orders 的托管 MCP 服务（mcp.zovo.one）；无需登录；Streamable HTTP；16 个工具。
暂无 AI 概览：以下信息来自注册中心条目和服务本身。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.theluckystrike%2Fbilling-docs-credit-notes-purchase-orders/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"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:
来源：servers/billing-docs/README.md，提交 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.
linesnotesreason必填invoice必填issue_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.
id必填Render 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.
id必填out_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.
id必填greetingsign_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.
id必填Raise 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.
items必填notescurrencysupplier必填tax_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.
id必填Render 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.
id必填out_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.
id必填greetingsign_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.
id必填datenotepartialDelete 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.
id必填Credited 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.
无需输入参数。
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.
key必填已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
{ "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"] } }}