NormAPI MCP Server

by normapi Your server? Claim it

answering

NormAPI is answering right now. Last checked 7 min ago. 415 installs a week from npm. It exposes 3 tools.

Validate and generate German e-invoices (XRechnung, ZUGFeRD) against the official KoSIT rules.

Installs per day peak 353 · avg 13

a month agotoday

Uptime history 50 hours of history

50 hours agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

342 ms

Response time

average over 24h

415

Installs / week

npm and PyPI

Nothing serious here today

Today is the operative word: we check NormAPI every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 7 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://normapi.com/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

This one needs environment variables set before it will start: NORMAPI_API_KEY (Your NormAPI API key (nk_live_…), needed only to generate invoices. Free at https://normapi.com/en/account/keys.). The author declared them in the registry entry; get the values from the project itself.

Available tools 3

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

explain

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.

generate

generate_invoice

Produce an XRechnung (`ubl` or `cii` XML) or a ZUGFeRD hybrid PDF (`zugferd`) from invoice data. 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 refused with the broken rules and how to fix each. Needs the user's NormAPI account; each document counts against the monthly allowance (25 free).

validate

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`, or the PDF base64-encoded in `pdfBase64` — exactly one. Free, no account needed, 5 MB at most.

Endpoints

URL	Transport	State	Latency	Checked
https://normapi.com/mcp	streamable-http	answering	266 ms	7 min ago

Alternatives to NormAPI

same job, measured the same way

Xrechnung MCP

by imysfylmz

Validate and parse German e-invoices (XRechnung, ZUGFeRD, Factur-X) offline. No API key.

31 installs/wk local only

Fakturai — German E-Invoice (ZUGFeRD / Factur-X / E-Rechnung)

by fakturai

KoSIT-verified German e-invoices: generate & validate ZUGFeRD, Factur-X, XRechnung, EN 16931.

3 tools answering

Kontor MCP

by dashankanadeeshandesilva

Offline e-invoice tools for AI agents: validate, audit, convert and generate XRechnung/ZUGFeRD.

40 installs/wk local only

Einvoice

by makririch

XRechnung & ZUGFeRD: create, validate, and convert German e-invoices. EN 16931 compliant.

49 installs/wk local only

Einvoicewiz

by einvoicewiz

Generate & validate EN 16931 e-invoices (Factur-X, ZUGFeRD, XRechnung); verification certificates

7 tools answering

Dropcoin Invoice

by freshfos

German e-invoicing: generate XRechnung 3.0, pre-check and extract (incl. ZUGFeRD PDF). Paid.

3 tools answering

Tallystick

by tally-stick

Read, validate and write e-invoices on your own machine. XRechnung, ZUGFeRD, Factur-X, UBL, CII.

92 installs/wk local only

Invapi MCP

by invapi-org

Extract, create, convert & validate invoices (UBL, CII, XRechnung, ZUGFeRD, PDF, Excel)

36 installs/wk local only

NormAPI — questions

Answers built from our own checks of this server.

What can NormAPI do?

It exposes 3 tools, read directly from the server on our last check. Among them: explain_rule, generate_invoice, validate_invoice. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is NormAPI working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 342 ms. The bar chart above shows every period we have measured.

How do I connect NormAPI?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does NormAPI need an API key?

No. NormAPI completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 3 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is NormAPI?

It answers our handshake in 342 ms on average, which is faster than 41% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use NormAPI?

The npm package @normapi/mcp was installed 415 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.