InvoiceXML — Claude Code MCP server for e-invoices
Wires your agent to the InvoiceXML API so it can create, validate, convert and extract e-invoices in Factur-X, ZUGFeRD, XRechnung, UBL and Peppol BIS Billing 3.0.
claude mcp add --transport http invoicexml https://mcp.invoicexml.comWhat InvoiceXML does
InvoiceXML is an MCP server that puts the InvoiceXML REST API in front of an AI agent. The agent can then build invoices, check them against the spec, move them between formats and pull structured data back out of finished files. Factur-X, ZUGFeRD, XRechnung, UBL / CII and Peppol BIS Billing 3.0 are all covered.
One codebase, two deployment shapes, picked at startup by Mcp:AuthMode. With ApiKey you host it yourself and supply the key through INVOICEXML_API_KEY or appsettings.json. With OAuth it runs on InvoiceXML infrastructure and authenticates clients via OAuth 2.1 with dynamic client registration. Running it locally takes the .NET 10 SDK and an InvoiceXML API key — no key, no server.
The host exposes the MCP endpoint at POST http://localhost:5004/, a welcome page at GET / and /health. It keeps no state, so you can put several instances behind a load balancer; terminate TLS at your own proxy. A new tool is one class marked [McpServerTool], a new auth mode is one branch in AuthExtensions.cs.
What it helps with
- generate an XRechnung invoice from order data
- validate a Factur-X file against the spec
- convert an invoice from UBL to ZUGFeRD
- extract line items and totals from a received e-invoice
- prepare a document for Peppol BIS Billing 3.0
Example prompts for the agent
- Build an XRechnung invoice from this order data and validate it
- Parse
invoice.xmland list the line items with totals - Convert this UBL invoice to ZUGFeRD
How to install InvoiceXML
Platform CLI: remote server
claude mcp add --transport http invoicexml https://mcp.invoicexml.comPlatform CLI: remote server
codex mcp add invoicexml --url https://mcp.invoicexml.comConfig file
{
"mcpServers": {
"invoicexml": {
"url": "https://mcp.invoicexml.com"
}
}
}Config file
{
"servers": {
"invoicexml": {
"type": "http",
"url": "https://mcp.invoicexml.com"
}
}
}Platform CLI: remote server
gemini mcp add -t http invoicexml https://mcp.invoicexml.comStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about InvoiceXML
How do I install InvoiceXML in Claude Code?
Run claude mcp add --transport http invoicexml https://mcp.invoicexml.com.
What does InvoiceXML do?
It hands the agent tools for e-invoice work: creating, validating, converting and extracting. Formats include Factur-X, ZUGFeRD, XRechnung, UBL / CII and Peppol BIS Billing 3.0.
What do I need to run it locally?
The .NET 10 SDK and an InvoiceXML API key. Set the key with dotnet user-secrets or the INVOICEXML_API_KEY environment variable.
