McpStamp Credit Notes

io.github.theluckystrike由 GitHub 帳號 theluckystrike 發布v0.23.0更新於 Nov 3, 2026

對發票的全部或部分金額進行貸記並衝回增值稅,建立採購訂單,列印A4 PDF。

AI 翻譯由 AI 模型根據下方的原文描述翻譯,可能有誤。

原文描述

Credit all or part of an invoice with the VAT reversed, raise purchase orders, print A4 PDFs.

已驗證Streamable HTTP可網頁執行效率與工作流金融

概覽

McpStamp Credit Notes 的託管 MCP 服務(mcp.zovo.one);無需登入;Streamable HTTP;16 個工具。

暫無 AI 概覽:以下資訊來自註冊中心條目和服務本身。

端點
mcp.zovo.one
最近檢查

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 McpStamp Credit Notes,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.theluckystrike%2Fcredit-memo/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mcpstamp-credit-notes": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/credit-note"
    }
  }
}

README

mcp-credit-note

[theluckystrike/mcp-credit-note MCP server]

In the official MCP Registry (io.github.theluckystrike/credit-note). Credit notes (credit memos) for freelancers and small businesses, kept the way the paperwork keeps them. Issue a credit against an invoice or standalone: the recipient, the reason (returned goods, overcharge, discount correction, service issue, other), line items with quantity, unit price and tax rate, and the currency. Every credit note starts as a draft you can revise and delete; finalizing burns the final CN-YYYY-NNNN number and freezes it, because a finalized credit note is a document the client may have seen. Render one to Markdown to paste into an email, or to a self-contained printable HTML page, and get the totals credited per currency, reason and month. Every amount is an integer number of minor units, and nothing is sent anywhere.

Built by theluckystrike.

npm publish for @theluckystrike/mcp-credit-note is pending, so npx -y @theluckystrike/mcp-credit-note returns 404 today. Until then, a clone+build is the working path.

Install

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

json
{  "mcpServers": {    "credit-note": {      "command": "npx",      "args": ["-y", "@theluckystrike/mcp-credit-note"]    }  }}

Claude Code

sh
claude mcp add credit-note -- npx -y @theluckystrike/mcp-credit-note

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project), same entry as Claude Desktop.

Tools

toolwhat it does
credit_note_createIssue a credit note against an invoice or standalone: recipient, reason, lines with quantity, unit price in minor units and tax rate, currency. Returns a CN-DRAFT-YYYY-NNNN draft
credit_note_updateRevise a draft while it is still a draft: recipient, reason, lines, currency, invoice reference, issue date or notes. New lines replace all old ones. A finalized note is refused by name
credit_note_finalizeBurn the final CN-YYYY-NNNN number and freeze the note: from here it cannot be edited or deleted, only rendered and listed
credit_note_listList credit notes with number, recipient, reason, status, issue date and total. Filter by recipient, reason, status, and issue-date period
credit_note_getRead one credit note in full by CN number or draft id: every line, the tax lines, the totals, the reason and the notes
credit_note_deleteDelete a draft entered wrongly. A finalized note is refused: it is a document the client may have seen
credit_note_renderRender a credit note as Markdown to paste into an email, or as a self-contained printable HTML page. Drafts render with a DRAFT banner
credit_note_summaryTotal credited per currency over finalized notes, broken down by reason and by month, in an optional issue-date period
license_status / license_activateFree or Pro, and the key

Free vs Pro

FreePro
Finalized credit notes10, lifetimeUnlimited
Drafts (credit_note_create, credit_note_update)UnlimitedUnlimited
Delete a draft (credit_note_delete)YesYes
Listing, reading (credit_note_list, credit_note_get)UnlimitedUnlimited
Rendering (credit_note_render)Unlimited, one-line footerUnlimited, no footer
Totals (credit_note_summary)UnlimitedUnlimited

Finalizing is the metered act because that is what turns a draft into the document the client sees. Everything else is free and unlimited: a free tier that withholds the rendered document or the totals is a demo, and ten real finalized credit notes is a working year for a freelancer who credits an invoice now and then.

Get Pro: https://mcp.zovo.one/buy/credit-note, $19 one-time for this server, or $39 for the bundle.

The rounding rule

Every amount is an integer number of minor units (cents), and the line math is documented so the printed document reproduces on a calculator:

  1. The unit price enters as integer minor units, so nothing is rounded on input. The line gross is quantity x unit price, rounded half-up once: gross = round_half_up(quantity * unit_price_minor). A whole quantity is exact; a fractional one (2.5 hours at EUR 33.33) lands on the nearest cent, and 2.5 x 3333 = 8332.5 rounds to 8333, never banker's 8332.
  2. Tax is computed per line and rounded half-up per line: tax = round_half_up(gross * rate / 100).
  3. The line total is gross + tax, and the note totals are plain integer sums of the already-rounded line values.

Round per line, then sum: a total can never drift from the printed lines by more than the rounding already visible on those lines, so the tax line at 23% is on its own base (the 23% lines only), not on the whole subtotal.

Numbering

Drafts carry a CN-DRAFT-YYYY-NNNN id no client sees. The final CN-YYYY-NNNN number is assigned only at finalize, in the issue date's year, and the counter is written before the record, so a crash burns a number rather than reusing one. Because drafts never hold a final number and finalized notes cannot be deleted, the final series never has a gap.

Privacy

All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/credit-note/. Two files: notes.json, counter.json. Nothing is sent anywhere, there is no account, no API key and no network call in this server at all. License keys are verified offline. The Markdown and HTML renders are returned as text; this server writes no document files.

Built by theluckystrike. https://github.com/theluckystrike

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:

來源:servers/credit-note/README.md,提交 6535b33

工具

16

credit_note_create

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_minor

credit_note_list

List 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.

輸入參數tofromclientinvoice

credit_note_get

Show 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必填

credit_note_pdf

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_path

credit_note_text

Plain-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_off

credit_note_delete

Delete 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必填

purchase_order_create

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_date

purchase_order_list

List 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.

輸入參數tofromstatussupplier

purchase_order_get

Show 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必填

purchase_order_pdf

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_path

purchase_order_text

Plain-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_off

purchase_order_receive

Mark 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必填datenotepartial

purchase_order_delete

Delete 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必填

billing_docs_report

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.

輸入參數tofrom

license_status

License 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.

無需輸入參數。

license_activate

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必填

版本歷史

6
  1. v0.23.0最新Nov 3, 2026
  2. v0.22.7Oct 14, 2026
  3. v0.22.3Sep 23, 2026
  4. v0.22.2Sep 22, 2026
  5. v0.22.0Sep 17, 2026
  6. v0.21.0Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分