# io.github.theluckystrike/billing-docs-credit-notes-purchase-orders (mcpb · billing-docs.mcpb)

Credit notes against your invoices and purchase orders to suppliers, with VAT and A4 PDFs.

- Trust score: 48/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- remote · `mcp.zovo.one`: 83/100, [markdown](https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/mcp-billing-docs.md), [page](https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/mcp-billing-docs)
- mcpb · `billing-docs.mcpb`: 48/100 (this document), [markdown](https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-billing-do.md), [page](https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-billing-do)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/billing-docs.mcpb`
- Version: `0.22.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 22/100
  - Malware scan not yet available for this package.
  - Known CVEs were checked across the 157 of 157 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - 63 of 157 dependencies flagged as unhealthy (2 deprecated).
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 86/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1787 tokens (~105/item across 17 items; 16 tools + 1 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "credit_note_delete" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

- Download bundle: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/billing-docs.mcpb`

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-17 (score 48)

First indexed and scored.

## MCP tools (16)

### `credit_note_create` (~209 tokens)

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.

Input parameters:

- `amount_minor` (integer): Credit this GROSS amount, VAT included, in minor units. Split across the invoice's VAT rates in proportion to each rate's share of the total
- `invoice` (string, required): The invoice number to credit, e.g. INV-2026-0001
- `issue_date` (string): YYYY-MM-DD, defaults to today in your business profile's timezone
- `lines` (array): Credit only these invoice lines. Leave out with amount_minor for a full credit note
- `notes` (string): Free text printed under the totals
- `reason` (string, required): Why the money is being given back, e.g. "returned goods" or "billed twice". Printed on the document

### `credit_note_list` (~109 tokens)

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.

Input parameters:

- `client` (string): Only credit notes for clients whose name contains this text
- `from` (string): YYYY-MM-DD, earliest issue date
- `invoice` (string): Only credit notes issued against this invoice number
- `to` (string): YYYY-MM-DD, latest issue date

### `credit_note_get` (~81 tokens)

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.

Input parameters:

- `id` (string, required): Credit note id such as CN-2026-0001, or an exact client name

### `credit_note_pdf` (~98 tokens)

Render the credit note as a PDF

Call this tool to write one credit note as an A4 PDF and return the path: the invoice layout titled CREDIT NOTE, with the invoice it reverses and the reason at the foot. Pro; credit_note_text is free.

Input parameters:

- `id` (string, required): Credit note id such as CN-2026-0001
- `out_path` (string): Where to write the file. Defaults to the billing-docs data directory under pdf/

### `credit_note_text` (~112 tokens)

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. Free; credit_note_pdf writes the A4 document.

Input parameters:

- `greeting` (string): Opening line, default "Hello" plus the client name
- `id` (string, required): Credit note id such as CN-2026-0001
- `sign_off` (string): Closing line, default your business name from the shared profile

### `credit_note_delete` (~76 tokens)

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.

Input parameters:

- `id` (string, required): Credit note id such as CN-2026-0001, or an exact client name

### `purchase_order_create` (~271 tokens)

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.

Input parameters:

- `currency` (string): Defaults to your business default currency
- `discount_percent` (number): Discount applied to every line, in percent
- `expected_delivery_date` (string): YYYY-MM-DD, when the goods or work are due
- `issue_date` (string): YYYY-MM-DD, defaults to today in your business profile's timezone
- `items` (array, required): What is being ordered
- `notes` (string): Free text printed under the totals, e.g. delivery address or terms
- `supplier` (string, required): Supplier name or client id. A name the invoice server already knows brings its address, email and VAT id onto the order
- `supplier_address` (string): Postal address for the SUPPLIER block, newlines allowed
- `supplier_email` (string): Only if the user gave it; otherwise the stored client's email is used
- `supplier_vat_id` (string): Supplier VAT / tax registration id
- `tax_rate` (number): VAT percent for lines with no rate of their own. Defaults to the business default

### `purchase_order_list` (~103 tokens)

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.

Input parameters:

- `from` (string): YYYY-MM-DD, earliest order date
- `status` (string): Default "all"
- `supplier` (string): Only orders to suppliers whose name contains this text
- `to` (string): YYYY-MM-DD, latest order date

### `purchase_order_get` (~76 tokens)

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.

Input parameters:

- `id` (string, required): Purchase order id such as PO-2026-0001, or an exact supplier name

### `purchase_order_pdf` (~94 tokens)

Render the purchase order as a PDF

Call this tool to write one purchase order as an A4 PDF and return the path: the invoice layout titled PURCHASE ORDER, with the buyer, supplier and delivery date. Pro; purchase_order_text is free.

Input parameters:

- `id` (string, required): Purchase order id such as PO-2026-0001
- `out_path` (string): Where to write the file. Defaults to the billing-docs data directory under pdf/

### `purchase_order_text` (~111 tokens)

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. Free on every tier.

Input parameters:

- `greeting` (string): Opening line, default "Hello" plus the supplier name
- `id` (string, required): Purchase order id such as PO-2026-0001
- `sign_off` (string): Closing line, default your business name from the shared profile

### `purchase_order_receive` (~141 tokens)

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.

Input parameters:

- `date` (string): YYYY-MM-DD, defaults to today
- `id` (string, required): Purchase order id such as PO-2026-0001
- `note` (string): What arrived, e.g. "8 of 10 units, 2 back-ordered"
- `partial` (boolean): True when only some of the order arrived. The order stays open and can be received again. Default false

### `purchase_order_delete` (~74 tokens)

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.

Input parameters:

- `id` (string, required): Purchase order id such as PO-2026-0001, or an exact supplier name

### `billing_docs_report` (~86 tokens)

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.

Input parameters:

- `from` (string): YYYY-MM-DD, earliest document date to count
- `to` (string): YYYY-MM-DD, latest document date to count

### `license_status` (~54 tokens)

License status

Report this server's licence state: product, tier free or pro, licence id, expiry, the key source and the upgrade URL. No arguments, no network. Explains a free-tier refusal; license_activate installs a key.

### `license_activate` (~71 tokens)

Activate license

Activate a Pro key (MCPL1.xxx.yyy) from checkout: verified offline against a built-in public key, saved to your config file. A wrong, malformed or expired key is refused, unsaved. license_status reads it back.

Input parameters:

- `key` (string, required): License key from the checkout confirmation page

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-billing-do#diagnostics

## Score history

- 2026-09-20: 48
- 2026-09-19: 48
- 2026-09-18: 48
- 2026-09-17: 48

## Common questions

### What is the io.github.theluckystrike/billing-docs-credit-notes-purchase… MCP server?

io.github.theluckystrike/billing-docs-credit-notes-purchase… is an MCP server listed in the public MCP registry as io.github.theluckystrike/billing-docs-credit-notes-purchase…. Credit notes against your invoices and purchase orders to suppliers, with VAT and A4 PDFs. This page covers its MCPB bundle (https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/billing-docs.mcpb).

### Is the io.github.theluckystrike/billing-docs-credit-notes-purchase… MCP server safe to use?

io.github.theluckystrike/billing-docs-credit-notes-purchase… scores 48 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.theluckystrike/billing-docs-credit-notes-purchase… MCP server expose?

io.github.theluckystrike/billing-docs-credit-notes-purchase… exposes 16 tools: credit_note_create, credit_note_list, credit_note_get, credit_note_pdf, credit_note_text, and 11 more. Their descriptions and schemas cost roughly 1,766 tokens of context every time the server is loaded.

### What licence is the io.github.theluckystrike/billing-docs-credit-notes-purchase… MCP server under?

io.github.theluckystrike/billing-docs-credit-notes-purchase… declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/theluckystrike/mcp-servers
- Website: https://mcp.zovo.one/s/billing-docs
- Changelog RSS feed: https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-billing-do.xml
- Changelog JSON feed: https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-billing-do.json
- HTML version of this page: https://verifymcp.io/servers/theluckystrike-billing-docs-credit-notes-purchase-orders/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-billing-do
