Skip to content

Releases: digitaldev-lx/mcp-invoice-express

Release list

v1.1.1 — versão do server corrigida

v1.1.1 — versão do server corrigida Latest
Latest

Choose a tag to compare

View all tags
@digitaldev-lx digitaldev-lx released this 17 Jul 13:39
v1.1.1
d31c214

O server reportava a versão errada aos clientes MCP. O SERVER_VERSION era um literal mantido à mão a duplicar o package.json, e derrapou: a v1.1.0 foi publicada a anunciar-se como 1.0.0 no handshake MCP.

Passa a ser lido do package.json em runtime, logo não pode voltar a divergir. Um teste novo fixa a igualdade entre os dois.

Sem alterações funcionais — o fix do generate_document_pdf da v1.1.0 mantém-se tal e qual.

Changelog completo: https://github.com/digitaldev-lx/mcp-invoice-express/blob/main/CHANGELOG.md

Assets 2
Loading

v1.1.0 — generate_document_pdf corrigido

v1.1.0 — generate_document_pdf corrigido

Choose a tag to compare

View all tags
@digitaldev-lx digitaldev-lx released this 17 Jul 10:30
v1.1.0
cc7f965

A generate_document_pdf nunca funcionou desde a v1.0.0. Pedia {root}/{id}/pdf.json (ex. invoices/3/pdf.json), um caminho que não existe: a API devolvia 404 para documentos emitidos, pagos e visíveis no InvoiceXpress.

Ao contrário do resto da API, a geração de PDF vive num endpoint único e agnóstico ao tipo de documento: api/pdf/{id}.json. Confirmado contra uma conta real.

O teste existente mockava o caminho errado — passava contra um endpoint inventado e perpetuava o bug. Passa a fixar o caminho real e a cobrir o second_copy.

Breaking-ish

A generate_document_pdf deixa de aceitar document_type: o endpoint corrigido é o mesmo para todos os tipos, logo o parâmetro não tinha significado. Chaves extra são ignoradas pelo zod, e como a tool devolvia 404 para qualquer input antes desta versão, nenhum caller funcional dependia dele.

Changelog completo: https://github.com/digitaldev-lx/mcp-invoice-express/blob/main/CHANGELOG.md

Loading

v1.0.0 — Initial production release

v1.0.0 — Initial production release

Choose a tag to compare

View all tags
@digitaldev-lx digitaldev-lx released this 02 May 23:39
v1.0.0
e244bea

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

Loading