MCP tools
Tool inputs, outputs, confirmation rules and availability.
Setup: MCP · Cursor · Claude Code · ChatGPT.
Business tools return JSON in structuredContent and text. Domain failures set isError; invalid inputs are rejected by the MCP SDK. Read/write OAuth scopes and current workspace permissions gate every tool.
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, saved invoice ID and assumptions — or validation issues. Binary artifacts are kept out of model context; use get_invoice for stored PDF/ISDOC links.
Prop
Type
The issuer is locked server-side
An issuer inside draft is rejected. The issuer is the workspace
default (is_default), or its first saved business if none is marked default.
If the connected workspace has no usable issuer, the tool fails. Use
get_workspace to inspect the seller before drafting; no issuer preset ID is
accepted.
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.
get_workspace
Returns the connected workspace ID and default issuer. Read this before drafting.
list_clients
Returns up to 200 saved client summaries from the connected workspace.
update_invoice_draft
Takes id (saved draft UUID) and patch (confirmed changed fields). Read the invoice first.
Nested meta/client/payment fields merge; an items array replaces the entire line-item list.
The issuer remains locked and issued invoices cannot be edited.
open_invoicey
Remote hosts can open the interactive invoice workspace with an optional query string.
Supporting hosts also expose navigation and composer invoice mentions.
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, validated payload when present, and stored PDF/ISDOC URLs.
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, non-cancelled invoice with the PDF and, by default, the ISDOC. Hosted Invoicey handles email delivery. Review the recipient and explicitly confirm sending; blocked To or Cc addresses are rejected. See email delivery for delivery status and retries.
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 the same connected workspace.
Not available over MCP
- Dedicated issuer/client administration — use the web UI; draft creation can save its validated recipient
- Historical import — web only, by design
- Unmarking an invoice as paid
- Cancelling an invoice