Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
作者提供的说明(英文原文)
Credit notes against issued invoices and purchase orders to suppliers, with VAT and A4 PDFs.
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
选择你使用的 AI 应用,然后复制设置。
MCP_LICENSE_KEY标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
https://mcp.zovo.one/mcp/billing-docs链接指向作者自己的文件;我们不托管也不重新打包它。打开文件后,Claude Desktop 会进行安装。
在终端中运行这条命令
claude mcp add --transport http billing-docs-credit-notes-purchase-order https://mcp.zovo.one/mcp/billing-docs运行前请先填写空着的值。
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"billing-docs-credit-notes-purchase-order": {
"url": "https://mcp.zovo.one/mcp/billing-docs"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"billing-docs-credit-notes-purchase-order": {
"type": "http",
"url": "https://mcp.zovo.one/mcp/billing-docs"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
https://mcp.zovo.one/mcp/billing-docs菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
工具名称和描述与服务器在 2026年11月6日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
credit_note_createCredit 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.
credit_note_listList 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.
credit_note_getReturn 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.
credit_note_pdfCall 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.
credit_note_textTurn 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.
credit_note_deleteRemove 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.
purchase_order_createRaise 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.
purchase_order_listList 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.
purchase_order_getReturn 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.
purchase_order_pdfCall 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.
purchase_order_textTurn 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.
purchase_order_receiveRecord 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.
purchase_order_deleteRemove 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.
billing_docs_reportOver 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.
license_statusReport 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_activateTurn Pro on for this connection with key, an MCPL1. . 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.
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日
注册名称已通过 GitHub 账户 theluckystrike 验证,该账户拥有此仓库
代码最后更新于3天前
我们还没有从 GitHub 读取这个仓库
在 52 毫秒内响应(HTTP 200)
无需登录
已读取 16 个工具描述,未发现针对 AI 的隐藏指令
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 4 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
你需要填写:MCP_LICENSE_KEY
两种方式都可以:安装在你的电脑上,或者连接云端版本。
GitHub 仓库最后更新于3天前,最新版本(0.23.0)于8天前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
同一分类中有:Spree Commerce developer docs for AI agents, Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.theluckystrike%2Fbilling-docs-credit-notes-purchase-orders/versions/latest) (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):
{
"mcpServers": { "billing-docs": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-billing-docs"] } } }
Claude Code:
claude mcp add billing-docs -- npx -y @theluckystrike/mcp-billing-docs
Cursor (.cursor/mcp.json):
{
"mcpServers": { "billing-docs": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-billing-docs"] } } }
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.
| tool | what it does |
|---|---|
credit_note_create | Credit an invoice: the whole thing, a gross amount, or named lines with quantities |
credit_note_list | Every credit note, with the credited total per currency. Filter by invoice, client or date |
credit_note_get | One credit note in full |
credit_note_pdf | The A4 PDF, titled CREDIT NOTE and carrying the invoice number it reverses (Pro) |
credit_note_text | The plain-text version to paste into an email |
credit_note_delete | Remove one that was never posted to its invoice or rendered: the free monthly slot comes back |
purchase_order_create | Raise an order: line items, VAT, currency, expected delivery date |
purchase_order_list | Every order with its status: open, partially received, received |
purchase_order_get | One order in full, with its receipts |
purchase_order_pdf | The A4 PDF, titled PURCHASE ORDER (Pro) |
purchase_order_text | The plain-text version to send the supplier |
purchase_order_receive | Mark an order received, in full or in part |
purchase_order_delete | Remove one with nothing received against it and no render: the free monthly slot comes back |
billing_docs_report | Credited per currency, on order per currency, deliveries past their date (Pro) |
license_status, license_activate | Free or Pro, and how to upgrade |
One resource, billing-docs://open-orders, and one prompt, chase_deliveries.
| Free | Pro | |
|---|---|---|
| Documents per calendar month | 5, credit notes and purchase orders together | Unlimited |
credit_note_delete, purchase_order_delete | Yes: the cap counts what is in the store, so a delete returns the slot | Yes |
credit_note_text, purchase_order_text | Yes, unlimited | Yes |
| Full, partial and per-line credit notes, VAT, multi-currency, receiving orders | Yes | Yes |
credit_note_pdf, purchase_order_pdf | No | Yes, plus your logo and no footer credit |
billing_docs_report | No | Yes |
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: support@zovo.one
Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install: