# NormAPI

> NormAPI is a freemium MCP server for finance and payments. Validate, generate and read German e-invoices (XRechnung, ZUGFeRD) against KoSIT rules. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://normapi.com/en/docs/mcp
- **MCP Registry name:** com.normapi/mcp
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-14

## About

Checking an e-invoice and creating one are treated differently. Validating, reading and looking up rules need no account, while generating needs a NormAPI account and counts against a monthly allowance of 50 free invoices. Validation and parsing never count.

The validator checks XRechnung in UBL or CII, or a ZUGFeRD or Factur-X PDF, against the official KoSIT ruleset (v2026-08-31 at the time of writing) and returns each finding with an explanation of what the rule requires, why it typically fires and how to fix it. Generation computes totals server-side in decimal arithmetic, validates the document before returning it and refuses data the rules do not permit. ZUGFeRD PDFs can be printed on an uploaded letterhead.

The server is hosted at `normapi.com/mcp` with OAuth, or run locally with `npx -y @normapi/mcp` and an API key. Invoices are processed in memory and not stored, up to 5 MB each. The docs stress that this is technical validation, not tax or legal advice.

## Features

- **E-invoice validation:** Checks XRechnung or ZUGFeRD files against the official KoSIT rules and lists every finding.
- **Rule explanations:** Each business-rule finding says what the rule requires and how to fix it.
- **Invoice parsing:** Reads a received e-invoice into structured data in the shape the generator takes.
- **Invoice generation:** Builds XRechnung or ZUGFeRD PDF from invoice data, validated before return.
- **Rule lookup:** Explains codes such as BR-DE-15 or BR-CO-10 with a link to the full page.
- **No storage:** Invoices are processed in memory and never stored.

## Good for

- Find out why an XRechnung is rejected
- Generate a compliant invoice from structured data
- Read a supplier's incoming e-invoice into JSON
- Look up what a BR-DE rule code means

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://normapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://normapi.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://normapi.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://normapi.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://normapi.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://normapi.com/mcp"
    }
  }
}
```

## Tools

- `validate_invoice`: Check an XRechnung (UBL or CII XML) or a ZUGFeRD/Factur-X PDF against the official KoSIT rules. Returns the verdict, the rule set version, and every finding; each business-rule finding comes with a plain-language meaning, cause and fix. Send the XML as text in `xml`, the PDF base64-encoded in `pdfBase64`, or an uploaded file in `file` — exactly one. No account needed; 5 MB at most.
- `parse_invoice`: Read a received e-invoice — XRechnung or any EN 16931 invoice as UBL or CII XML, or a ZUGFeRD/Factur-X PDF — into structured data. `invoice` is in exactly the shape generate_invoice takes (fields the document lacks are left out); `stated` has the totals, the VAT breakdown and each line net as the document states them, as exact decimal strings; `notMapped` lists by path every value of the document 
- `generate_invoice`: Produce an e-invoice as `ubl` or `cii` XML or a ZUGFeRD hybrid PDF (`zugferd`) from invoice data: an XRechnung for a public-sector buyer (profile `xrechnung`, the default), a plain EN 16931 invoice for a business (profile `en16931`). Totals are computed server-side in decimal arithmetic, and the document is validated against the official rules before it is returned. Data the rules do not permit is
- `explain_rule`: Explain one EN 16931 / XRechnung / Peppol business rule by its code (e.g. BR-DE-15, BR-CO-10, PEPPOL-EN16931-R010): what it requires, why invoices typically break it, and how to fix it, with a link to the full page. Case does not matter. Schema findings (cvc-*) have no explanation.

## FAQ

### Do I need an account?

Not for validating, reading or looking up rules. Generating invoices requires one.

### What does it cost?

Validation is free. Accounts include 50 generated invoices a month; paid plans start at €19 a month for 500 invoices, €49 for 2,500 and €149 for 10,000.

### Where is data processed?

In Germany (Düsseldorf), and the site says invoice content is not stored.

### How do I connect it?

Add `https://normapi.com/mcp` as a connector, or run `npx -y @normapi/mcp` with `NORMAPI_API_KEY` for stdio clients.

### Does it include sending invoices?

No. Sending by email or Peppol, archiving and Peppol receiving are not included.

### Is NormAPI free?

NormAPI has a free plan, with paid plans for more usage or features.

### How do I add NormAPI to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://normapi.com/mcp

### What are the best alternatives to NormAPI?

The closest alternatives to NormAPI 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/normapi
