MCP tools
Tool inputs, outputs, confirmation rules and availability.
Setup: MCP · Cursor · Claude Code.
Every tool returns a JSON result with an ok boolean. Failures carry a message rather than throwing.
lookup_business
Look up a Czech economic subject by IČO via ARES. Returns draft client fields — without an id,
which is assigned when saved.
Prop
Type
Prefer this over search_business once the IČO is known.
search_business
Search by company name (obchodní jméno). Returns matches with IČO and structured address; follow up
with lookup_business on the chosen IČO.
Prop
Type
create_invoice
Assemble a draft, validate it against the schema, and render the PDF and ISDOC. Returns the validated invoice, base64 PDF and ISDOC XML — or the list of validation issues.
Prop
Type
The issuer is locked server-side
Any issuer inside draft is ignored. The issuer is the workspace
default (is_default). If the workspace has no issuer, the tool fails — a
demo issuer is never written to Neon. A model cannot put a bank account or IČO
on your invoice.
Do not pass issuerPresetId or templatePresetId — those arguments do not exist.
Nothing is silently defaulted. Omitting duzp is an error, not an invoice dated today. Field rules:
invoice schema.
list_invoices
Workspace invoices as summaries, each with both the domain status and the UI displayStatus.
Prop
Type
get_invoice
One invoice: summary with status, plus the validated payload when present.
Prop
Type
issue_invoice
Issues a draft with atomic numbering. Idempotent if the invoice is already issued.
Prop
Type
mark_invoice_paid
Sets paidAt on an issued, unpaid invoice.
Prop
Type
There is no unmark_invoice_paid over MCP — that one is web-only.
send_invoice_email
Emails an issued invoice with the PDF and, by default, the ISDOC. Needs RESEND_API_KEY as well as a
database.
Prop
Type
Pass to explicitly when the client has no contact email. Do not let an
assistant guess an address — this tool sends real mail to real people.
Presets
list_presets
Prop
Type
get_preset
Prop
Type
save_preset
Creates or updates. Omit id to create.
Prop
Type
For kind: "issuer", data must be a complete issuer snapshot — name, IČO, address, bank account,
VAT flag, contact email. For kind: "invoice_template", any partial draft: meta, vat, payment,
items.
delete_preset
Prop
Type
Storage
Presets are stored in your Invoicey workspace database and available to every MCP session that uses your personal API key.
Not available over MCP
- Creating issuers or clients — web UI only; MCP consumes them via presets
- Historical import — web only, by design
- Unmarking an invoice as paid
- Cancelling an invoice