{"name":"io.github.theluckystrike/invoice-pdf-billing-generator","slug":"theluckystrike-invoice-pdf-billing-generator","title":null,"description":"Create PDF invoices from your AI chat: clients, numbering, VAT, overdue reports. All data is local.","url":"https://mcp.market/server/theluckystrike-invoice-pdf-billing-generator","grade":"C","score":64,"certified":false,"status":"active","category":"finance","tags":["finance"],"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/theluckystrike/mcp-servers","website":"https://mcp.zovo.one/s/invoice","version":"0.22.0","remotes":[{"type":"streamable-http","url":"https://mcp.zovo.one/mcp/invoice","headers":[{"description":"Bearer <Pro license key or anonymous token from GET https://mcp.zovo.one/mcp/token>","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"mcpb","identifier":"https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/invoice.mcpb","version":"0.22.0","fileSha256":"70a83cd255861f2a648ae13b1c79e5ba1e5116a6983583061ffeae4a1fb909ba","transport":{"type":"stdio"},"environmentVariables":[{"description":"Optional Pro license key (MCPL1....). Verified offline.","isSecret":true,"name":"MCP_LICENSE_KEY"}]}],"tools":[{"name":"business_set","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","description":"Your business or freelancer name"},"address":{"type":"string","description":"Postal address, newlines allowed"},"email":{"type":"string","description":"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"},"phone":{"type":"string","description":"Your own phone number. Same rule as email: only if the user gave it"},"timezone":{"type":"string","description":"IANA zone you work in, e.g. Europe/Warsaw. Shared with time-tracker (entries are stamped in it) and timezone (your home zone)"},"vat_id":{"type":"string","description":"VAT / tax registration id"},"iban":{"type":"string","description":"IBAN or account number for payment"},"bank":{"type":"string","description":"Bank name / BIC"},"logo_path":{"type":"string","description":"Path to a PNG or JPG logo (Pro)"},"default_currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"ISO code, e.g. EUR, USD, JPY. Default EUR"},"default_tax_rate":{"type":"number","description":"Default VAT percent applied to items without their own rate"},"payment_terms_days":{"type":"number","description":"Default days until due. Default 14"},"invoice_prefix":{"type":"string","description":"Invoice number prefix, default INV (custom prefix is Pro)"},"tax_rate":{"type":"number","description":"Alias for default_tax_rate"},"vat_rate":{"type":"number","description":"Alias for default_tax_rate"},"vat":{"type":"number","description":"Alias for default_tax_rate"}},"required":["name"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"client_add","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":"string"},"email":{"type":"string"},"vat_id":{"type":"string","description":"Client VAT id, printed for reverse-charge invoices"}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"client_delete","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"client":{"type":"string","description":"Client name or id, exactly as client_list shows it"}},"required":["client"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"client_list","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"invoice_create","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"client":{"type":"string","description":"Client name or id. Unknown names are added automatically"},"items":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"quantity":{"type":"number","minimum":-1000000000000,"maximum":1000000000000,"description":"Hours, units or 1 for a flat fee"},"unit_price":{"type":"number","minimum":-1000000000000,"maximum":1000000000000,"description":"Price per unit in major units, e.g. 90 for 90 EUR"},"tax_rate":{"type":"number","minimum":-100,"maximum":1000,"description":"VAT percent for this line, overrides the business default"},"vat_rate":{"$ref":"#/properties/items/items/properties/tax_rate","description":"Alias for tax_rate"},"vat":{"$ref":"#/properties/items/items/properties/tax_rate","description":"Alias for tax_rate"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Currency this line was captured in. Every line on one invoice must agree; convert first with expense_to_invoice target_currency + fx_rates"},"round_total":{"type":"boolean","description":"D-R46: round this line's TOTAL to the exact converted amount instead of rounding the unit price to cents first. Default false keeps the D-R24 basis (unit price x quantity always equals the printed gross); true trades that off so the gross matches an fx conversion to the cent."}},"required":["description","quantity","unit_price"],"additionalProperties":false},"description":"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"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"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 conversion argument to pass rather than billed as if it were one currency"},"issue_date":{"type":"string","description":"YYYY-MM-DD, defaults to today"},"due_days":{"type":"number","description":"Days until due, defaults to your payment terms"},"notes":{"type":"string","description":"Free text printed under the totals"},"discount_percent":{"type":"number","minimum":0,"maximum":100,"description":"Discount percent applied to every line before tax, 0-100"}},"required":["client","items"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"invoice_from_hours","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"client":{"type":"string"},"hours":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"rate":{"type":"number","minimum":-1000000000000,"maximum":1000000000000,"description":"Hourly rate in major units, expressed in currency (or the business default currency)"},"description":{"type":"string","description":"Line description, default 'Consulting services'"},"tax_rate":{"type":"number","minimum":-100,"maximum":1000},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Currency the rate is in. Without target_currency this is also the invoice currency"},"target_currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Issue the invoice in this currency instead, converting the rate. Needs fx_rates for the rate currency"},"fx_rates":{"type":"object","additionalProperties":{"type":"number","exclusiveMinimum":0},"description":"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, e.g. {\"EUR\": 1.1578} with target_currency \"USD\". You supply the rate; nothing here fetches or guesses one"},"entry_ids":{"type":"array","items":{"type":"string"},"description":"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"},"issue_date":{"type":"string"},"due_days":{"type":"number"},"notes":{"type":"string"},"discount_percent":{"type":"number","minimum":0,"maximum":100},"round_total":{"type":"boolean","description":"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 always equals the printed line, so a rounding_note explains any drift from the exact conversion); true removes the drift but unit_price x hours may then be a cent or two off the printed total."}},"required":["client","hours","rate"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"invoice_get","description":"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).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"number":{"type":"string"}},"required":["number"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"invoice_list","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"status":{"type":"string","enum":["unpaid","paid","partial"]},"client":{"type":"string"},"from":{"type":"string","description":"YYYY-MM-DD inclusive"},"to":{"type":"string","description":"YYYY-MM-DD inclusive"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"invoice_mark_paid","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"number":{"type":"string"},"paid_date":{"type":"string","description":"YYYY-MM-DD, defaults to today"},"amount":{"type":"number","exclusiveMinimum":0,"description":"Amount received in major units, ADDED to what is already paid on this invoice. Omit to pay off the remaining balance in full"},"method":{"type":"string","description":"How it was paid, e.g. bank transfer, card. Stored on this payment's row"},"reference":{"type":"string","description":"Bank reference or transaction id for this payment. Stored on this payment's row"}},"required":["number"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"invoice_pdf","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"number":{"type":"string","description":"Invoice number to render, as returned by invoice_create"},"out_path":{"type":"string","description":"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 tax line per rate, the total, payment details and notes, and every money value on it carries its currency code. Use a .pdf path: the bytes written are always PDF"}},"required":["number"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"license_activate","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"key":{"type":"string","description":"License key from checkout, MCPL1.<payload>.<signature>"}},"required":["key"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"license_status","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"overdue_report","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"as_of":{"type":"string","description":"YYYY-MM-DD, defaults to today"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"scan":{"score":64,"grade":"C","scanned_at":"2026-09-17T16:31:55.236Z","report":{"scannerVersion":"0.1.2","scannedAt":"2026-09-17T16:31:55.181Z","components":{"code":{"score":-1,"max":25,"notes":["package could not be scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 290ms"]},"poisoning":{"score":15,"max":15,"notes":["13 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":3,"max":15,"notes":["repository not readable: github 401"]},"identity":{"score":2,"max":10,"notes":["no repository or website to verify"]}},"findings":[],"inputs":{"probes":[{"url":"https://mcp.zovo.one/mcp/invoice","reachable":true,"authRequired":false,"latencyMs":290,"serverInfo":{"name":"mcp-invoice","version":"0.22.0"}}],"packages":[],"repo":{"found":false,"owner":"theluckystrike","repo":"mcp-servers","error":"github 401"}}}},"grade_history":[]}