Factur-X by Orvel

Factur-X MCP server

Generate, validate and read Factur-X / EN 16931 e-invoices over MCP or REST.
Hosted by Orvel. Factur-X PDF/A-3 · CII · UBL 2.1 · French fr-ctc rules.

Demo and MCP setup · Pricing and allowances · Conformity reports · Status

Endpoint: https://facturx.orvel.dev/mcp (Streamable HTTP)
Registry identifier: io.github.LeBorgneAntoine/facturx

For developers integrating invoice generation, validation or extraction into an ERP, SaaS or agent workflow. The service produces and checks files; it is not a Plateforme Agréée or a Peppol access point and does not deliver invoices to recipients.

Try before paying

Fixed synthetic samples and helper tools work without an API key. Try the valid sample report and invalid sample report, or connect an MCP client and ask:

Show the invalid invoice demo and explain its findings. Do not upload or process my documents.

The demo accepts only its bundled samples. It is not free processing of your own invoices.

Try your own documents: eligible verified accounts can start a bounded trial of 10 operations over 14 days, with up to 30 processing attempts, no card and no renewal. Launch availability is limited. Start in the Factur-X workspace. See the current paid allowances, pricing and terms before purchase.

Connect

For your own documents with an account: connect a compatible OAuth MCP client to https://facturx.orvel.dev/mcp/account, authenticate in the browser and approve access to your trial or linked plan. Existing /mcp integrations and public fixed samples remain available. Authenticate again when switching endpoints; tokens are endpoint-specific.

For Cursor, a no-key connection in .cursor/mcp.json can inspect the service and run the fixed demo:

{
  "mcpServers": {
    "facturx": {
      "url": "https://facturx.orvel.dev/mcp"
    }
  }
}

For paid document processing, add "headers": { "Authorization": "Bearer YOUR_KEY" } to the server configuration using your own key. Keep credentials out of version control. The same key and quota cover REST and MCP.

For OAuth setup, Claude, VS Code and other clients, use the maintained MCP connection guide.

Tools

Tool	Purpose
view_invoice_demo	Inspect fixed synthetic valid/invalid samples without uploading a document
get_invoice_example	Get structured invoice or credit-note examples
explain_finding	Explain a validation rule
check_party	Check one invoice party
check_invoice_parties	Check seller and buyer together
generate_invoice	Generate Factur-X PDF/A-3, CII or UBL from invoice JSON
embed_xml	Embed CII XML into an existing PDF
validate_invoice	Check your document and return structured findings
extract_invoice	Extract invoice fields from PDF/XML
draft_credit_note	Draft a full or partial credit note

Each tool describes its inputs and access requirements. Document operations consume quota; a client should not retry a completed operation blindly.

Generation profiles: BASIC WL, EN 16931, EXTENDED and EXTENDED-CTC-FR. UBL generation supports EN 16931 and EXTENDED-CTC-FR. Reading/validation also supports other Factur-X profiles; see the API reference.

Verify the result

Read valid, findings, checks_run and checks_skipped in the report. A successful HTTP response alone does not establish which checks ran, independent PDF/A certification or successful delivery to a PA.

Published sample files and independent Mustangproject validation reports are available on the conformity page, with scope and known warnings.

REST API

The same engine is available through:

• POST /v1/invoices/generate
• POST /v1/invoices/embed
• POST /v1/invoices/validate
• POST /v1/invoices/extract

Generation expects {"invoice": {...}, "options": {...}}, not bare invoice JSON. Use Accept: application/json to return file content in base64 alongside totals and the validation report in one request.

OpenAPI · REST reference

n8n workflow

Import the free n8n invoice workflow to generate a PDF and check its validation report in one API request. The template uses built-in nodes and your own API credentials. API access and quota follow the current account offers.

About

Built and operated by Orvel. Privacy · Terms · Support: support@orvel.dev.

This repository holds the public manifest, brand assets and connection examples of the hosted service. The engine itself is closed source.