# Conformo e-invoicing

> Conformo e-invoicing is an open-source MCP server for finance and payments. Create and validate XRechnung, ZUGFeRD and Factur-X e-invoices locally in an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows
- **Website:** https://conformo-docs.vercel.app
- **Repository:** https://github.com/arsalmurad/conformo/tree/HEAD/packages/mcp-server
- **MCP Registry name:** io.github.arsalmurad/conformo
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-14

## About

Conformo's MCP server is a thin wrapper over its JavaScript toolkit, so an agent can turn invoice data into compliant e-invoice files and check them against the official rule sets. It handles XRechnung, ZUGFeRD and Factur-X PDF/A-3, Peppol BIS Billing 3.0, plain CII and UBL.

Everything runs on your machine: the README says no account, no API key and no network call from any tool. Validation runs the KoSIT, CEN and Peppol rules and XSDs, and the README reports that verdicts match the official KoSIT validator on its test invoices. Failed rules come back with the publisher's message and a plain-language fix.

Money is passed as integer minor units, so 1234 means EUR 12.34. Node 20 or newer is required, with stdio by default or stateless Streamable HTTP for a shared deployment.

## Features

- **Create invoice XML:** Builds CII, UBL, XRechnung and Peppol XML from JSON.
- **Factur-X PDF output:** Produces PDF/A-3 with embedded XML.
- **Official rule validation:** Runs XSD and Schematron rule sets and reports which ran.
- **Rule explanations:** Explains failed rules like BR-CO-15 with a fix.
- **Format conversion:** Converts or parses invoices between syntaxes and the JSON model.
- **Country requirements:** Looks up mandates, dates and thresholds per country.

## Good for

- Draft an XRechnung for a public-sector customer
- Check a received invoice and see why it fails
- Convert a UBL invoice to a ZUGFeRD PDF
- Look up e-invoicing rules for a country
- Add invoice checks to a CI pipeline

## Install

### Claude Code (Terminal)

```sh
claude mcp add conformo -- npx -y @conformo/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "conformo": {
      "command": "npx",
      "args": [
        "-y",
        "@conformo/mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "conformo": {
      "command": "npx",
      "args": [
        "-y",
        "@conformo/mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "conformo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@conformo/mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "conformo": {
      "command": "npx",
      "args": [
        "-y",
        "@conformo/mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "conformo": {
      "command": "npx",
      "args": [
        "-y",
        "@conformo/mcp-server"
      ]
    }
  }
}
```

## Tools

- `create_invoice`: Turns a structured invoice into XML in CII, UBL, XRechnung or Peppol syntaxes.
- `create_invoice_pdf`: Builds a Factur-X or ZUGFeRD PDF/A-3 from the same input.
- `validate_invoice`: Validates XML or a PDF against XSDs and matching rule sets.
- `convert_invoice`: Converts an invoice between syntaxes.
- `parse_invoice`: Parses XML or PDF into the invoice JSON model.
- `get_country_requirements`: Returns mandates, dates and thresholds per country.
- `explain_validation_rule`: Explains a rule id in plain language with a fix.

## FAQ

### Does invoice data leave my computer?

The README says no tool makes a network call and invoices stay local.

### Is it free?

Yes, free and open source under Apache-2.0 with no usage limits.

### What do I need to run it?

Node.js 20 or newer; install with `claude mcp add conformo -- npx -y @conformo/mcp-server`.

### Is Conformo e-invoicing free?

Yes. Conformo e-invoicing is open source, so you can use and self-host it for free.

### How do I add Conformo e-invoicing to Claude Code?

Run this command in your terminal: claude mcp add conformo -- npx -y @conformo/mcp-server

### What are the best alternatives to Conformo e-invoicing?

The closest alternatives to Conformo e-invoicing are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/conformo-e-invoicing
