{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "normapi.com",
    "site": "normapi.com",
    "addresses": [
      {
        "address": "78.31.64.244",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 24961,
          "name": "MYLOC-AS - WIIT AG",
          "prefix": "78.31.64.0/21",
          "country": "DE"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "78.31.64.244"
        ],
        "first_seen": "2026-11-22T15:41:05.445Z",
        "last_seen": "2026-11-22T15:41:05.445Z",
        "checks": 1
      }
    ],
    "hosting": [],
    "software": [],
    "server_info": {
      "name": "normapi",
      "version": "1.4.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "strict-transport-security": "max-age=31536000; includeSubDomains; preload",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.normapi",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "13436",
    "server_name": "com.normapi/mcp",
    "url": "https://normapi.com/mcp",
    "host": "normapi.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T15:41:05.445Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "33cb966799913ea6679af7beabf96623bed247a8f3089bf0b101c53171dfdc8d",
    "first_listed_at": "2026-11-21T09:57:02.509Z",
    "created_at": "2026-11-21T06:25:06.713Z",
    "resolved_addresses": [
      "78.31.64.244"
    ]
  },
  "server": {
    "name": "com.normapi/mcp",
    "title": "NormAPI",
    "description": "Validate, generate and read German e-invoices (XRechnung, ZUGFeRD) against the official KoSIT rules.",
    "version": "1.4.0",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://normapi.com/en/docs/mcp",
    "published_at": "2026-11-13T20:20:15.006Z",
    "updated_at": "2026-11-13T20:20:15.006Z",
    "first_seen": "2026-11-21T06:25:06.035Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:17:10.773Z"
  },
  "operator": {
    "key": "normapi.com",
    "name": "normapi.com",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 1000,
    "first_check_in_window": "2026-11-21T09:57:02.509Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "33cb966799913ea6679af7beabf96623bed247a8f3089bf0b101c53171dfdc8d",
    "tools": 4,
    "resources": 1,
    "prompts": 0,
    "first_seen": "2026-11-21T09:57:03.505Z",
    "tool_names": [
      "validate_invoice",
      "parse_invoice",
      "generate_invoice",
      "explain_rule"
    ],
    "declared": {
      "tools": [
        {
          "name": "validate_invoice",
          "title": "Validate an e-invoice",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "xml": {
                "type": "string",
                "maxLength": 5242880,
                "description": "The invoice XML as text"
              },
              "file": {
                "type": "object",
                "required": [
                  "download_url",
                  "file_id"
                ],
                "properties": {
                  "file_id": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "The client's id for the file"
                  },
                  "file_name": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "mime_type": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "download_url": {
                    "type": "string",
                    "maxLength": 4096,
                    "description": "Where the file can be downloaded"
                  }
                },
                "description": "An uploaded file, handed over as a download link"
              },
              "fileName": {
                "type": "string",
                "maxLength": 200,
                "description": "The file name, echoed into the report only"
              },
              "language": {
                "enum": [
                  "en",
                  "de"
                ],
                "type": "string",
                "default": "en",
                "description": "Language of the plain-language explanations: en (default) or de"
              },
              "pdfBase64": {
                "type": "string",
                "maxLength": 6990511,
                "description": "A ZUGFeRD or Factur-X PDF, base64-encoded"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "acceptable",
              "rulesetVersion",
              "scenario",
              "schemaValid",
              "businessRulesEvaluated",
              "errors",
              "warnings",
              "findings"
            ],
            "properties": {
              "errors": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991
              },
              "findings": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "code",
                    "severity",
                    "origin",
                    "text",
                    "location",
                    "line",
                    "column",
                    "explanation"
                  ],
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "line": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "text": {
                      "type": "string",
                      "description": "The rule as the official rule set words it"
                    },
                    "column": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "origin": {
                      "enum": [
                        "SCHEMA",
                        "SCHEMATRON",
                        "PDFA",
                        "NORMAPI"
                      ],
                      "type": "string",
                      "description": "SCHEMA and SCHEMATRON are the rule set's findings, PDFA the PDF's, NORMAPI a note from NormAPI itself, such as a check that stopped part-way"
                    },
                    "location": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "XPath of the offending node; null for schema findings"
                    },
                    "severity": {
                      "enum": [
                        "ERROR",
                        "WARNING",
                        "INFORMATION"
                      ],
                      "type": "string"
                    },
                    "explanation": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": [
                            "meaning",
                            "cause",
                            "fix",
                            "url"
                          ],
                          "properties": {
                            "fix": {
                              "type": "string"
                            },
                            "url": {
                              "type": "string"
                            },
                            "cause": {
                              "type": "string"
                            },
                            "meaning": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Plain-language meaning, cause and fix; every business rule has one, schema findings and NormAPI notes none"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "scenario": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The rules that judged the document; null means nothing was checked"
              },
              "warnings": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991
              },
              "acceptable": {
                "type": "boolean",
                "description": "The verdict: true when no ERROR-severity finding remains"
              },
              "schemaValid": {
                "type": "boolean"
              },
              "rulesetVersion": {
                "type": "string",
                "description": "The KoSIT rule set release that produced the verdict"
              },
              "businessRulesEvaluated": {
                "type": "boolean",
                "description": "False when a schema failure stopped the run, so an empty list is not a pass"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Validate an e-invoice",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "parse_invoice",
          "title": "Read an e-invoice into data",
          "description": "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 the data does not carry. Send the XML as text in `xml`, the PDF base64-encoded in `pdfBase64`, or an uploaded file in `file` — exactly one. `validate: true` adds the KoSIT verdict. No account needed; 5 MB at most.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "xml": {
                "type": "string",
                "maxLength": 5242880,
                "description": "The invoice XML as text"
              },
              "file": {
                "type": "object",
                "required": [
                  "download_url",
                  "file_id"
                ],
                "properties": {
                  "file_id": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "The client's id for the file"
                  },
                  "file_name": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "mime_type": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "download_url": {
                    "type": "string",
                    "maxLength": 4096,
                    "description": "Where the file can be downloaded"
                  }
                },
                "description": "An uploaded file, handed over as a download link"
              },
              "language": {
                "enum": [
                  "en",
                  "de"
                ],
                "type": "string",
                "default": "en",
                "description": "Language of the plain-language explanations: en (default) or de"
              },
              "validate": {
                "type": "boolean",
                "default": false,
                "description": "Also check the invoice against the KoSIT rules and return the verdict"
              },
              "pdfBase64": {
                "type": "string",
                "maxLength": 6990511,
                "description": "A ZUGFeRD or Factur-X PDF, base64-encoded"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "syntax",
              "documentKind",
              "source",
              "specificationId",
              "businessProcess",
              "profile",
              "invoice",
              "readyToGenerate",
              "missingForGeneration",
              "stated",
              "notMapped",
              "validation"
            ],
            "properties": {
              "source": {
                "type": "object",
                "required": [
                  "kind",
                  "attachment"
                ],
                "properties": {
                  "kind": {
                    "enum": [
                      "xml",
                      "pdf"
                    ],
                    "type": "string"
                  },
                  "attachment": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "For a PDF, the embedded file the invoice was read from"
                  }
                },
                "additionalProperties": false
              },
              "stated": {
                "type": "object",
                "required": [
                  "lineTotal",
                  "allowanceTotal",
                  "chargeTotal",
                  "netTotal",
                  "vatTotal",
                  "vatAccountingCurrency",
                  "vatTotalInAccountingCurrency",
                  "grossTotal",
                  "prepaidAmount",
                  "roundingAmount",
                  "amountDue",
                  "vatBreakdown",
                  "lines",
                  "allowances",
                  "charges"
                ],
                "properties": {
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "netAmount",
                        "priceDiscount",
                        "allowances",
                        "charges"
                      ],
                      "properties": {
                        "charges": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "amount"
                            ],
                            "properties": {
                              "amount": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "netAmount": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "BT-131"
                        },
                        "allowances": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "amount"
                            ],
                            "properties": {
                              "amount": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "priceDiscount": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "BT-147"
                        }
                      },
                      "additionalProperties": false
                    },
                    "description": "One per invoice line, in the same order"
                  },
                  "charges": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "amount"
                      ],
                      "properties": {
                        "amount": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    },
                    "description": "One per document charge"
                  },
                  "netTotal": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-109, the total without VAT"
                  },
                  "vatTotal": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-110, in the invoice currency"
                  },
                  "amountDue": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-115"
                  },
                  "lineTotal": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-106, the sum of the line nets"
                  },
                  "allowances": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "amount"
                      ],
                      "properties": {
                        "amount": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    },
                    "description": "One per document allowance"
                  },
                  "grossTotal": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-112, the total with VAT"
                  },
                  "chargeTotal": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-108"
                  },
                  "vatBreakdown": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "category",
                        "rate",
                        "taxableAmount",
                        "vatAmount",
                        "exemptionReason",
                        "exemptionReasonCode"
                      ],
                      "properties": {
                        "rate": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "category": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "vatAmount": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "taxableAmount": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "exemptionReason": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "exemptionReasonCode": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "BT-121, which the invoice data does not carry"
                        }
                      },
                      "additionalProperties": false
                    },
                    "description": "BG-23, one entry per VAT category and rate"
                  },
                  "prepaidAmount": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-113"
                  },
                  "allowanceTotal": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-107"
                  },
                  "roundingAmount": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-114"
                  },
                  "vatAccountingCurrency": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-6, when VAT is also accounted in another currency"
                  },
                  "vatTotalInAccountingCurrency": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "BT-111, the VAT total in that currency"
                  }
                },
                "additionalProperties": false
              },
              "syntax": {
                "enum": [
                  "ubl",
                  "cii"
                ],
                "type": "string"
              },
              "invoice": {
                "type": "object",
                "description": "The invoice in the shape generate_invoice takes, with what the document lacks left out. Amounts are numbers; the exact decimals of the totals are in `stated`. Where the document has them, it also carries identifierScheme on the parties, taxCurrency and vatTotalInTaxCurrency, and for a French invoice `france`, with what only France asks of an invoice; generate_invoice does not take these yet, so readyToGenerate is false while one is there.",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "profile": {
                "anyOf": [
                  {
                    "enum": [
                      "xrechnung",
                      "en16931",
                      "france"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The profile that declares exactly this BT-24. xrechnung and en16931 are what generate_invoice takes; france marks an invoice read as French, which generate_invoice does not write yet. null for any other declaration"
              },
              "notMapped": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "path",
                    "count"
                  ],
                  "properties": {
                    "path": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer",
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991
                    }
                  },
                  "additionalProperties": false
                },
                "description": "Every value of the document `invoice` and `stated` do not carry: a path without positions and how often. Empty for an invoice NormAPI generated."
              },
              "validation": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "acceptable",
                      "rulesetVersion",
                      "scenario",
                      "schemaValid",
                      "businessRulesEvaluated",
                      "errors",
                      "warnings",
                      "findings"
                    ],
                    "properties": {
                      "errors": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991
                      },
                      "findings": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "code",
                            "severity",
                            "origin",
                            "text",
                            "location",
                            "line",
                            "column",
                            "explanation"
                          ],
                          "properties": {
                            "code": {
                              "type": "string"
                            },
                            "line": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "maximum": 9007199254740991,
                                  "minimum": -9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "text": {
                              "type": "string",
                              "description": "The rule as the official rule set words it"
                            },
                            "column": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "maximum": 9007199254740991,
                                  "minimum": -9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "origin": {
                              "enum": [
                                "SCHEMA",
                                "SCHEMATRON",
                                "PDFA",
                                "NORMAPI"
                              ],
                              "type": "string",
                              "description": "SCHEMA and SCHEMATRON are the rule set's findings, PDFA the PDF's, NORMAPI a note from NormAPI itself, such as a check that stopped part-way"
                            },
                            "location": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "XPath of the offending node; null for schema findings"
                            },
                            "severity": {
                              "enum": [
                                "ERROR",
                                "WARNING",
                                "INFORMATION"
                              ],
                              "type": "string"
                            },
                            "explanation": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "required": [
                                    "meaning",
                                    "cause",
                                    "fix",
                                    "url"
                                  ],
                                  "properties": {
                                    "fix": {
                                      "type": "string"
                                    },
                                    "url": {
                                      "type": "string"
                                    },
                                    "cause": {
                                      "type": "string"
                                    },
                                    "meaning": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Plain-language meaning, cause and fix; every business rule has one, schema findings and NormAPI notes none"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "scenario": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The rules that judged the document; null means nothing was checked"
                      },
                      "warnings": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991
                      },
                      "acceptable": {
                        "type": "boolean",
                        "description": "The verdict: true when no ERROR-severity finding remains"
                      },
                      "schemaValid": {
                        "type": "boolean"
                      },
                      "rulesetVersion": {
                        "type": "string",
                        "description": "The KoSIT rule set release that produced the verdict"
                      },
                      "businessRulesEvaluated": {
                        "type": "boolean",
                        "description": "False when a schema failure stopped the run, so an empty list is not a pass"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "With validate: true, the verdict as validate_invoice returns it; otherwise null"
              },
              "documentKind": {
                "enum": [
                  "invoice",
                  "creditNote"
                ],
                "type": "string",
                "description": "UBL says so by its root element; in CII the type code (BT-3) decides"
              },
              "businessProcess": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "BT-23"
              },
              "readyToGenerate": {
                "type": "boolean",
                "description": "Whether `invoice` passes generate_invoice's schema as it is. False for a French invoice, which generate_invoice does not write yet, and for an invoice that carries a field generate_invoice does not take yet: it would be left out"
              },
              "specificationId": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "BT-24, the rules the document declares"
              },
              "missingForGeneration": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "What generate_invoice would refuse in `invoice`, field by field; empty when ready"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Read an e-invoice into data",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "generate_invoice",
          "title": "Generate an e-invoice",
          "description": "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 refused with the broken rules and how to fix each. Needs the user's NormAPI account; each generated document counts against that account's monthly allowance.",
          "inputSchema": {
            "truncated": true,
            "chars": 22079
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "syntax",
              "profile",
              "fileName",
              "mimeType",
              "bytes",
              "rulesetVersion",
              "scenario",
              "letterhead",
              "letterheadSkipped"
            ],
            "properties": {
              "xml": {
                "type": "string",
                "description": "The XML document; absent for the ZUGFeRD PDF, which is the attached resource"
              },
              "bytes": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991
              },
              "syntax": {
                "enum": [
                  "ubl",
                  "cii",
                  "zugferd"
                ],
                "type": "string"
              },
              "profile": {
                "enum": [
                  "xrechnung",
                  "en16931"
                ],
                "type": "string",
                "description": "xrechnung for public-sector buyers: it requires buyerReference (the Leitweg-ID), a seller contact and both electronic addresses. en16931 for businesses (§ 14 UStG accepts it), without those."
              },
              "fileName": {
                "type": "string"
              },
              "mimeType": {
                "type": "string"
              },
              "scenario": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "letterhead": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The id of the account's letterhead the ZUGFeRD PDF is printed on; null when it is not, for XML, and for an account without a letterhead"
              },
              "rulesetVersion": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The rule set the document passed before it was returned"
              },
              "letterheadSkipped": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Why the account's letterhead was left out: requested, customer-call, seller-mismatch, needs-confirmation, recheck-failed or render-failed; null when it was used, for XML, and for an account without a letterhead"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Generate an e-invoice",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "explain_rule",
          "title": "Explain an e-invoice rule",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "maxLength": 60,
                "minLength": 2,
                "description": "The rule code, e.g. BR-DE-15"
              },
              "language": {
                "enum": [
                  "en",
                  "de"
                ],
                "type": "string",
                "default": "en",
                "description": "Language of the plain-language explanations: en (default) or de"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "code",
              "language",
              "meaning",
              "cause",
              "fix",
              "url"
            ],
            "properties": {
              "fix": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "cause": {
                "type": "string"
              },
              "meaning": {
                "type": "string"
              },
              "language": {
                "enum": [
                  "de",
                  "en",
                  "fr"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Explain an e-invoice rule",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "invoice-card",
          "uri": "ui://normapi/invoice-card.html",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Shows a generated e-invoice with what it passed and a button that saves the file"
        }
      ],
      "prompts": []
    },
    "instructions": "NormAPI checks, produces and reads German e-invoices (XRechnung in UBL or CII, ZUGFeRD/Factur-X PDF) against the official KoSIT rule set, and states the rule set version with every result.\n\nvalidate_invoice needs no account. Its verdict is `acceptable`; every business-rule finding carries a plain-language explanation (meaning, cause, fix) — quote the fix rather than paraphrasing the rule text.\n\nparse_invoice needs no account either. It reads a received invoice into data: `invoice` in the shape generate_invoice takes, `stated` with the totals as the document wrote them, and `notMapped` naming every value it did not carry. Answer questions about an invoice from this data rather than from the raw XML, and say so when notMapped lists something relevant.\n\ngenerate_invoice turns invoice data into a document that passed validation before it was returned. It needs the user's NormAPI account and counts against their monthly allowance, so build the invoice from data the user gave you and do not retry blindly: a refusal names the rules the data breaks.\n\nPick its profile by the recipient: xrechnung (the default) for a public-sector buyer, en16931 for a business, which then needs no Leitweg-ID, contact person or electronic addresses.\n\nWhen the user's account has a letterhead (uploaded at normapi.com/konto/briefkopf), zugferd PDFs are printed on it automatically; pass letterhead \"none\" only when the user asks for NormAPI's standard layout.\n\nexplain_rule explains a rule code (e.g. BR-DE-15) the user already has.\n\nInvoices are processed in memory and never stored. This is technical validation, not tax or legal advice."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}