# io.github.theluckystrike/invoice-pdf-billing-generator (mcpb · invoice.mcpb)

Create PDF invoices from your AI chat: clients, numbering, VAT, overdue reports. All data is local.

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

## Components

- remote · `mcp.zovo.one`: 84/100, [markdown](https://verifymcp.io/servers/theluckystrike-invoice-pdf-billing-generator/mcp-invoice.md), [page](https://verifymcp.io/servers/theluckystrike-invoice-pdf-billing-generator/mcp-invoice)
- mcpb · `invoice.mcpb`: 46/100 (this document), [markdown](https://verifymcp.io/servers/theluckystrike-invoice-pdf-billing-generator/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-invoice-mc.md), [page](https://verifymcp.io/servers/theluckystrike-invoice-pdf-billing-generator/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-invoice-mc)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/invoice.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-21.

- **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 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 82/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1868 tokens (~133/item across 14 items; 13 tools + 1 resources), over budget; trim descriptions and params.
  - 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**: 92/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 75% 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 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "client_delete" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 14 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/invoice.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 46)

First indexed and scored.

## MCP tools (13)

### `business_set` (~352 tokens)

Set your business details

The ONE business profile for the whole suite: name, address, VAT id, bank details and defaults (currency, tax rate, terms, prefix, timezone). Saved to the shared profile every other server reads. Call it once, first.

Input parameters:

- `address` (string): Postal address, newlines allowed
- `bank` (string): Bank name / BIC
- `default_currency` (string): ISO code, e.g. EUR, USD, JPY. Default EUR
- `default_tax_rate` (number): Default VAT percent applied to items without their own rate
- `email` (string): Your own email address. Leave it out unless the user gave it: no server ever fills an email from anything but this profile or an explicit argument
- `iban` (string): IBAN or account number for payment
- `invoice_prefix` (string): Invoice number prefix, default INV (custom prefix is Pro)
- `logo_path` (string): Path to a PNG or JPG logo (Pro)
- `name` (string, required): Your business or freelancer name
- `payment_terms_days` (number): Default days until due. Default 14
- `phone` (string): Your own phone number. Same rule as email: only if the user gave it
- `tax_rate` (number): Alias for default_tax_rate
- `timezone` (string): IANA zone you work in, e.g. Europe/Warsaw. Shared with time-tracker (entries are stamped in it) and timezone (your home zone)
- `vat` (number): Alias for default_tax_rate
- `vat_id` (string): VAT / tax registration id
- `vat_rate` (number): Alias for default_tax_rate

### `client_add` (~93 tokens)

Add a client

Store a client so invoice_create can refer to them by name. Re-adding the same name updates the stored address, email and VAT id; a record identical to a stored one is refused, naming the id that already holds it.

Input parameters:

- `address` (string)
- `email` (string)
- `name` (string, required)
- `vat_id` (string): Client VAT id, printed for reverse-charge invoices

### `client_delete` (~62 tokens)

Delete a client

Delete one stored client that nothing refers to. A client named on any invoice, quote, credit note, purchase order, deposit, statement or schedule is refused with those documents listed.

Input parameters:

- `client` (string, required): Client name or id, exactly as client_list shows it

### `client_list` (~49 tokens)

List clients

List every stored client with id, address, email and VAT id. No arguments, and it writes nothing. With none stored it says so: invoice_create also creates a client from the name you pass.

### `invoice_create` (~243 tokens)

Create an invoice

Create an invoice from line items and return the record with its next, never-reused number. unit_price is in MAJOR units; lines are rounded then summed. One currency per invoice. Free: 3 a month.

Input parameters:

- `client` (string, required): Client name or id. Unknown names are added automatically
- `currency` (string): Invoice currency, 3-letter ISO code. Defaults to the one currency every item agrees on, else your business default. Every line on one invoice must agree with it; a mix is refused with the exact conve…
- `discount_percent` (number): Discount percent applied to every line before tax, 0-100
- `due_days` (number): Days until due, defaults to your payment terms
- `issue_date` (string): YYYY-MM-DD, defaults to today
- `items` (array, required): Line items. Amounts are held as integer minor units and every line is rounded first, then summed, so the printed lines can never disagree with the total. A line may carry its own currency
- `notes` (string): Free text printed under the totals

### `invoice_from_hours` (~405 tokens)

Invoice from hours

Shortcut for the common case: bill one client for N hours at an hourly rate. Creates and returns a single-line invoice, converting the rate into target_currency when you supply fx_rates, and echoing back any entry_ids.

Input parameters:

- `client` (string, required)
- `currency` (string): Currency the rate is in. Without target_currency this is also the invoice currency
- `description` (string): Line description, default 'Consulting services'
- `discount_percent` (number)
- `due_days` (number)
- `entry_ids` (array): Time-tracker entry ids these hours came from (the entry_ids invoice_summary returns). Echoed back with the new invoice number so you can call entry_mark_billed
- `fx_rates` (object): Conversion rates, the same pair expense_to_invoice takes: fx_rates maps the RATE's currency to the number of target units one of it buys, meaning 1 unit of that currency = X units of target_currency,…
- `hours` (number, required)
- `issue_date` (string)
- `notes` (string)
- `rate` (number, required): Hourly rate in major units, expressed in currency (or the business default currency)
- `round_total` (boolean): D-R46: when converting with fx_rates, round the line's TOTAL to the exact converted amount instead of rounding the hourly rate to cents first. Default false keeps the D-R24 basis (unit price x hours…
- `target_currency` (string): Issue the invoice in this currency instead, converting the rate. Needs fx_rates for the rate currency
- `tax_rate` (number)

### `invoice_list` (~88 tokens)

List invoices

List invoices by number: client, dates, currency, subtotal, discount, tax lines, total, status, paid, credited and the balance still due after any credit note. Filter by status, client and date range.

Input parameters:

- `client` (string)
- `from` (string): YYYY-MM-DD inclusive
- `status` (string)
- `to` (string): YYYY-MM-DD inclusive

### `invoice_get` (~49 tokens)

Get one invoice

Return the full stored record for one invoice number, including every line, tax breakdown, and the balance still open after any credit note issued against it (see credited_minor).

Input parameters:

- `number` (string, required)

### `invoice_mark_paid` (~156 tokens)

Mark an invoice paid

Record a payment on one invoice. amount is in MAJOR units and ADDS to what is paid, never replaces it; omit it to settle the rest. An overpayment is refused, naming the open balance.

Input parameters:

- `amount` (number): Amount received in major units, ADDED to what is already paid on this invoice. Omit to pay off the remaining balance in full
- `method` (string): How it was paid, e.g. bank transfer, card. Stored on this payment's row
- `number` (string, required)
- `paid_date` (string): YYYY-MM-DD, defaults to today
- `reference` (string): Bank reference or transaction id for this payment. Stored on this payment's row

### `invoice_pdf` (~164 tokens)

Render invoice PDF

Call this tool to write one stored invoice as an A4 PDF and return the path: issuer, BILL TO, dates, items, taxes and totals. Free stamps a credit line and no logo; Pro renders it unbranded with your logo.

Input parameters:

- `number` (string, required): Invoice number to render, as returned by invoice_create
- `out_path` (string): Where to write the PDF; defaults to <data dir>/pdf/<number>.pdf. The page carries the issuer block, the BILL TO client block, dates, an item table with wrapped descriptions, subtotal, discount, one t…

### `overdue_report` (~62 tokens)

Overdue report

List every invoice not paid in full whose due date has passed, worst first, with days overdue and the amount, then a total per currency. Free. Use invoice_list for everything still open.

Input parameters:

- `as_of` (string): YYYY-MM-DD, defaults to today

### `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-invoice-pdf-billing-generator/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-invoice-mc#diagnostics

## Score history

- 2026-09-21: 46
- 2026-09-20: 46
- 2026-09-19: 46
- 2026-09-18: 46
- 2026-09-17: 46

## Common questions

### What is the io.github.theluckystrike/invoice-pdf-billing-generator MCP server?

io.github.theluckystrike/invoice-pdf-billing-generator is an MCP server listed in the public MCP registry as io.github.theluckystrike/invoice-pdf-billing-generator. Create PDF invoices from your AI chat: clients, numbering, VAT, overdue reports. All data is local. This page covers its MCPB bundle (https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/invoice.mcpb).

### Is the io.github.theluckystrike/invoice-pdf-billing-generator MCP server safe to use?

io.github.theluckystrike/invoice-pdf-billing-generator scores 46 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/invoice-pdf-billing-generator MCP server expose?

io.github.theluckystrike/invoice-pdf-billing-generator exposes 13 tools: business_set, client_add, client_delete, client_list, invoice_create, and 8 more. Their descriptions and schemas cost roughly 1,848 tokens of context every time the server is loaded.

### What licence is the io.github.theluckystrike/invoice-pdf-billing-generator MCP server under?

io.github.theluckystrike/invoice-pdf-billing-generator 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/invoice
- Changelog RSS feed: https://verifymcp.io/servers/theluckystrike-invoice-pdf-billing-generator/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-invoice-mc.xml
- Changelog JSON feed: https://verifymcp.io/servers/theluckystrike-invoice-pdf-billing-generator/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-invoice-mc.json
- HTML version of this page: https://verifymcp.io/servers/theluckystrike-invoice-pdf-billing-generator/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-invoice-mc