Skip to content
MCP server

NormAPI

Validate, generate and read German e-invoices (XRechnung, ZUGFeRD) against KoSIT rules

Status and history

Answered our latest tool-list check 21 hours ago with 4 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
1.4.0
Listing updated
3 days ago

About NormAPI

NormAPI is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://normapi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://normapi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • NORMAPI_API_KEYYour NormAPI API key (nk_live_…), needed only to generate invoices. Free at https://normapi.com/en/account/keys.

Tools this server provides (4)

Read directly from the server.

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.

What it does

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

Pricing

Freemium

Validation free; 50 generated invoices/month free; paid from €19/mo

Prices change. Check normapi.com before you buy.

NormAPI 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 to NormAPI

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments