Invoicing System MCP Tools

Invoicing System MCP tools follow quote, order, service record, invoice draft, approval, sending, payment, refund, credit note, payment reminder, recurring invoice, tax, accounting export, and audit workflows.

invoice.config.get

read

Read invoice numbering, payment terms, currency, tax, reminder, accounting export, and approval settings.

-

Read-only. No approval required.

Do not expose payment gateway secrets, accounting API tokens, or numbering reset controls.

invoice.branding_templates.get

read

Read branded invoice, quote, receipt, payment reminder, and multilingual templates.

invoice.config.get

Read-only. No approval required.

Hide unpublished templates unless the requester can manage finance documents.

invoice.customers.list

read

List billing customers, terms, currency, tax details, contacts, and collection preferences.

invoice.config.get

Read-only. No approval required.

Mask customer tax and contact details according to finance permission.

invoice.customer.get

read

Read one customer's invoices, quotes, payments, credit notes, overdue state, and credit history.

invoice.customers.list

Read-only. No approval required.

Keep customer finance records tenant-scoped and role-scoped.

invoice.quotes.list

read

List quote drafts, sent, accepted, expired, and invoice-convertible states.

invoice.customer.get

Read-only. No approval required.

Do not expose confidential pricing to users without sales or finance access.

invoice.quote.get

read

Read quote lines, discounts, tax, validity, customer acceptance, and invoice conversion diff.

invoice.quotes.list

Read-only. No approval required.

Preserve accepted quote snapshot; never mutate quote state from read endpoints.

invoice.source_records.list

read

List billable orders, completed services, project milestones, or subscription charges for the period.

invoice.config.get, invoice.customers.list

Read-only. No approval required.

Do not mark source records as invoiced from this endpoint.

invoice.billable_items.list

read

List billable items, unit prices, discounts, revenue categories, tax rates, and currency conversion.

invoice.source_records.list

Read-only. No approval required.

Show historical price snapshots when records are already quoted or ordered.

invoice.invoices.list

read

List invoices by customer, date, state, due date, currency, or overdue state.

invoice.customer.get

Read-only. No approval required.

Mask invoice PDFs or private notes unless the user can view finance documents.

invoice.invoice.get

read

Read invoice lines, number, tax, discounts, payments, sending, voiding, and audit history.

invoice.invoices.list

Read-only. No approval required.

Issued invoice snapshots must be immutable and clearly separated from drafts.

invoice.recurring_rules.list

read

List recurring rules for subscriptions or retainers, next run date, and exceptions.

invoice.config.get, invoice.customers.list

Read-only. No approval required.

Do not trigger invoice generation from read endpoints.

invoice.payment_methods.list

read

Read card, FPS, PayMe, bank transfer, and cash payment methods and availability.

invoice.config.get

Read-only. No approval required.

Never expose raw gateway credentials or stored payment instruments.

invoice.payments.list

read

List payments, refunds, reconciliation, payment proofs, outstanding balances, and gateway state.

invoice.invoice.get, invoice.customer.get

Read-only. No approval required.

Mask card, bank, payer, and gateway identifiers according to finance role.

invoice.credit_notes.list

read

List credit notes, refunds, overpayment applications, reversals, and original invoice links.

invoice.customer.get, invoice.payments.list

Read-only. No approval required.

Keep credit-note balances and application history immutable.

invoice.reminder_rules.list

read

Read reminder rules such as 1/7/14-day overdue steps, channels, templates, and pause lists.

invoice.config.get

Read-only. No approval required.

Respect customer communication preferences and do-not-chase flags.

invoice.tax_rules.list

read

Read tax rates, zero-rating, cross-border tax, exemptions, and effective dates.

invoice.config.get

Read-only. No approval required.

Return effective-dated tax rules and do not infer legal advice.

invoice.accounting_exports.list

read

List accounting export batches, periods, formats, states, errors, and re-export history.

invoice.config.get

Read-only. No approval required.

Do not expose accounting connector credentials or private ledger mappings.

invoice.aging_report.get

read

Read receivables aging, overdue customers, reminder stages, and cashflow risk.

invoice.invoices.list, invoice.payments.list

Read-only. No approval required.

Aggregate where possible; customer-level views require finance access.

invoice.revenue_summary.get

read

Read revenue, tax, discount, refund, product/service, and customer distribution summary.

invoice.invoices.list, invoice.credit_notes.list

Read-only. No approval required.

Use issued invoices and approved credit notes as source of truth.

invoice.audit_logs.list

read

Read audit logs for invoices, quotes, payments, credit notes, tax, templates, and exports.

invoice.invoice.get or invoice.customer.get

Read-only. No approval required.

Audit logs must be immutable and restricted to finance admin/compliance roles.

invoice.batch_create.preview

preview

Preview invoice batch generated from orders, service records, or quotes, including amounts, tax, payment terms, and missing data.

invoice.source_records.list, invoice.billable_items.list, invoice.customers.list, invoice.tax_rules.list

Finance approval required before creating or issuing customer-facing invoices.

Detect duplicate invoices, missing customer data, locked source records, and tax mismatch.

invoice.send.preview

preview

Preview invoice PDF/web view, recipients, message copy, payment buttons, and customer-visible data.

invoice.invoice.get, invoice.branding_templates.get, invoice.payment_methods.list

Approval required before sending invoices externally.

Check recipient scope, issued state, payment link validity, and sensitive internal notes.

invoice.payment_reminder.preview

preview

Preview overdue reminder audience, copy, channel, frequency, and customer pause state.

invoice.aging_report.get, invoice.reminder_rules.list, invoice.customer.get

Approval required for bulk reminders or sensitive overdue accounts.

Respect opt-out, do-not-chase flags, recent payment records, and tone policy.

invoice.recurring_run.preview

preview

Preview next recurring run customers, amounts, periods, exceptions, pauses, and payment terms.

invoice.recurring_rules.list, invoice.customers.list, invoice.tax_rules.list

Approval required before manual recurring run or rule change goes live.

Avoid duplicate monthly invoices and respect paused/cancelled subscriptions.

invoice.accounting_export.preview

preview

Preview export period, invoices, payments, refunds, credit notes, tax fields, and format errors.

invoice.accounting_exports.list, invoice.invoices.list, invoice.payments.list, invoice.credit_notes.list

Finance approval required before creating export files or pushing to accounting systems.

Prevent duplicate exports and keep reconciliation references stable.

invoice.credit_note.preview

preview

Preview credit note, refund, or overpayment application impact on original invoice, receivables, and accounting exports.

invoice.invoice.get, invoice.payments.list, invoice.credit_notes.list

Approval required for refunds, credit notes, and invoice balance adjustments.

Do not over-credit beyond available balance; preserve reason and approver.

invoice.customer.upsert

write

Create or update billing customer, contacts, terms, currency, tax details, and collection preferences.

invoice.customer.get or invoice.customers.list

Approval required for tax identity, payment terms, or sensitive contact changes.

Deduplicate customers and preserve previous billing identity in audit history.

invoice.quote.upsert

write

Create or update quote draft, lines, discounts, validity, tax, and customer-visible content.

invoice.quote.get, invoice.billable_items.list, invoice.tax_rules.list

Approval required before sending quote externally or changing accepted quote terms.

Version quote drafts and avoid overwriting accepted customer snapshots.

invoice.quote.accept

write

Record quote acceptance and lock invoice-convertible data.

invoice.quote.get

Approval required unless acceptance comes from verified customer action.

Store acceptance timestamp, actor, and immutable accepted quote snapshot.

invoice.draft.create

write

Create invoice draft from quote, order, service record, or manual data.

invoice.batch_create.preview

Approval required when creating invoices from bulk source records.

Do not consume invoice numbers until issue step; detect duplicate source records.

invoice.draft.update

write

Update draft invoice lines, discounts, tax, due date, payment methods, or notes.

invoice.invoice.get, invoice.batch_create.preview

Approval required for material amount, tax, or term changes.

Only draft invoices may be edited; issued invoices require credit note or void flow.

invoice.issue

write

Issue an approved invoice and lock number, amount, tax, and PDF snapshot.

invoice.batch_create.preview or invoice.invoice.get

Explicit finance approval required before execution.

Invoice number must be sequential/controlled and cannot be reused after issue.

invoice.send

write

Send invoice and payment link by email, WhatsApp, or customer portal.

invoice.send.preview

Approval required before customer-facing send.

Send only issued or approved draft documents according to tenant policy.

invoice.void

write

Void an invoice and record reason, receivable impact, customer notification, and audit.

invoice.invoice.get, invoice.credit_note.preview

Approval required for issued invoices.

Do not delete issued invoices; preserve voided number and legal/audit trail.

invoice.payment.record

write

Record customer payment, date, method, receipt, reconciliation state, and partial payment.

invoice.invoice.get, invoice.payments.list

Approval required for manual payments or backdated entries.

Prevent overpayment mismatch and preserve original proof file references.

invoice.refund.create

write

Create refund record linked to payment, invoice, credit note, or payment gateway.

invoice.credit_note.preview

Finance approval required before refund execution or record finalisation.

Never refund more than available paid balance; keep gateway and ledger references.

invoice.credit_note.create

write

Create credit note for future invoice application or refund support.

invoice.credit_note.preview

Approval required before issuing credit note.

Credit notes must be numbered, reasoned, and tied to original finance records.

invoice.payment_link.create

write

Create one-time payment link for invoice amount, expiry, and allowed methods.

invoice.invoice.get, invoice.payment_methods.list

Approval required for manual payment links or amount overrides.

Avoid duplicate active links and never expose raw gateway session secrets.

invoice.reminder_rule.upsert

write

Create or update reminder rules, intervals, templates, channels, and exceptions.

invoice.reminder_rules.list, invoice.payment_reminder.preview

Approval required for customer-facing reminder policy changes.

Check consent, tone, frequency, and no-contact customer exceptions.

invoice.reminder.send

write

Send individual or bulk payment reminders, overdue notices, or payment links.

invoice.payment_reminder.preview

Approval required for bulk or overdue reminders.

Recheck latest payment state immediately before sending.

invoice.recurring_rule.upsert

write

Create or update recurring invoice rule, cadence, customer, items, pricing, pauses, and end dates.

invoice.recurring_run.preview

Approval required before recurring rule affects future invoices.

Preserve historical generated invoices and prevent duplicate cycle generation.

invoice.accounting_export.create

write

Create accounting export file or push approved period data to accounting system.

invoice.accounting_export.preview

Finance approval required before export finalisation or external push.

Mark exported records with stable batch id and prevent silent overwrites.

invoice.tax_rule.update

write

Update tax rate, exemption condition, regional rule, and effective date.

invoice.tax_rules.list

Finance/admin approval required before tax rule changes.

Use effective dates; do not retroactively alter issued invoices without approved correction flow.

invoice.template.upsert

write

Create or update invoice, quote, receipt, reminder, and multilingual templates.

invoice.branding_templates.get, invoice.send.preview

Approval required before templates become customer-facing.

Validate variables, payment links, legal notes, and brand assets before publish.

invoice.action_request.status

status

Check status for invoicing writes, previews, or approval requests without re-executing actions.

invoice.audit_logs.list

Read-only status lookup. No approval required.

Return status and audit references only; never replay financial writes from this endpoint.