Skip to content

v1.0.0 — Initial production release

Choose a tag to compare

@digitaldev-lx digitaldev-lx released this 02 May 23:39
· 3 commits to main since this release

First production release of @digitaldev-lx/mcp-invoice-express.

MCP (Model Context Protocol) server for the InvoiceXpress API V2. Lets Claude Code and any other MCP-aware client operate the Portuguese invoicing platform directly.

Install in one line

claude mcp add invoice-express \
  --env INVOICE_EXPRESS_ACCOUNT_NAME=your-account-subdomain \
  --env INVOICE_EXPRESS_API_KEY=your-api-key \
  -- npx -y @digitaldev-lx/mcp-invoice-express

Highlights

  • 25 high-level tools + raw fallback covering the entire V2 API surface (invoices, simplified invoices, credit notes, debit notes, receipts, estimates, guides, purchase orders, clients, items, taxes, sequences, accounts, treasury, SAF-T).
  • 3 read-only resources (recent invoices, clients, account info) and 2 workflow prompts (create_invoice_workflow, monthly_close_workflow).
  • Single account per instance via INVOICE_EXPRESS_ACCOUNT_NAME + INVOICE_EXPRESS_API_KEY env vars; multi-account by configuring multiple MCP servers.
  • Retry & backoff on 429/5xx with typed error hierarchy.
  • TypeScript sources, Zod validation, 27 vitest tests.
  • One-liner install, Stdio transport, no extra dependencies.

See the README for the full reference.

Requirements

  • Node.js 20+
  • An InvoiceXpress account with an API key

License

MIT