{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-05T18:15:07.428Z","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp","markdownUrl":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp.md","server":{"slug":"com-normapi-mcp","name":"NormAPI","registryName":"com.normapi/mcp","description":"Validate, generate and read German e-invoices (XRechnung, ZUGFeRD) against the official KoSIT rules.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"normapi-mcp","type":"npm","identifier":"@normapi/mcp","withdrawn":false,"url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp","version":"1.3.1","transport":"stdio","scoredAt":"2026-11-05T04:33:13.531Z"},"score":{"total":75,"tier":"medium","status":"scored","weekDelta":3,"history":[{"date":"2026-11-05","total":75},{"date":"2026-11-04","total":75},{"date":"2026-11-03","total":75},{"date":"2026-11-02","total":74},{"date":"2026-11-01","total":74},{"date":"2026-10-31","total":58},{"date":"2026-10-30","total":73},{"date":"2026-10-29","total":72},{"date":"2026-10-28","total":70},{"date":"2026-10-27","total":69},{"date":"2026-10-26","total":69},{"date":"2026-10-25","total":68},{"date":"2026-10-24","total":68},{"date":"2026-10-23","total":52},{"date":"2026-10-22","total":52},{"date":"2026-10-21","total":52},{"date":"2026-10-20","total":64},{"date":"2026-10-19","total":64},{"date":"2026-10-18","total":64},{"date":"2026-10-17","total":64},{"date":"2026-10-16","total":64},{"date":"2026-10-15","total":64},{"date":"2026-10-14","total":64},{"date":"2026-10-13","total":34},{"date":"2026-10-12","total":34},{"date":"2026-10-11","total":34}]},"categories":[{"name":"Supply Chain Security","score":100,"verdict":"pass","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","No install/post-install scripts declared.","0 of 4 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.none","args":{}},{"code":"dephealth.assessed","args":{"deps":"4","unhealthy":"0"}}]},{"name":"Provenance & Transparency","score":19,"verdict":"fail","reasons":["Repository check failed: no source repository is declared.","Provenance check failed: no build-provenance attestation is published.","Clear OSI-approved license (MIT).","Actively maintained (last published 3 days ago).","Disclosure check failed: no security disclosure policy was found in the source repository."],"codes":[{"code":"provenance.repo_none","args":{}},{"code":"provenance.none","args":{}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"3"}},{"code":"disclosure.absent","args":{}}]},{"name":"Schema Quality & AI Usability","score":75,"verdict":"fail","reasons":["100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).","AI-judged instruction clarity (good).","Context-footprint check failed: tool/resource definitions use about 1236 tokens (~247/item across 5 items; 4 tools + 1 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.descriptions","args":{"pct":"100"}},{"code":"schema.ai_quality","args":{"band":"good"}},{"code":"schema.footprint_heavy","args":{"avg":"247","items":"5","tools":"4","tokens":"1236","resources":"1"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":73,"verdict":"partial","reasons":["Stability observed for 22 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"codes":[{"code":"stability.building_history","args":{"days":"22"}}]},{"name":"Tool Coverage","score":98,"verdict":"partial","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","94% of tool parameters carry a description.","Structured output schemas are declared (100% of tools); any adoption earns full credit."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"94"}},{"code":"toolquality.output_present","args":{"pct":"100"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","We read all 4 captured tool definition(s), and no name or description among them implies an irreversible operation.","An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_none","args":{"tools":"4"}},{"code":"toolsafety.manipulation_clean","args":{"units":"6","judged":"6"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a current MCP spec version (2026-07-28).","Supports UI / widget rendering."],"codes":[{"code":"protocol.current","args":{"version":"2026-07-28"}},{"code":"cap.ui_supported","args":{}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"normapi","type":"remote","identifier":"https://normapi.com/mcp","withdrawn":false,"score":85,"current":false,"url":"https://verifymcp.io/servers/com-normapi-mcp/normapi","markdownUrl":"https://verifymcp.io/servers/com-normapi-mcp/normapi.md"},{"slug":"normapi-mcp","type":"npm","identifier":"@normapi/mcp","withdrawn":false,"score":75,"current":true,"url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp","markdownUrl":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp.md"}],"facts":[{"label":"Registry","value":"npm"},{"label":"Package","value":"@normapi/mcp"},{"label":"Version","value":"1.3.1"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"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.","inputs":[{"name":"file","type":"object","required":false,"description":"An uploaded file, handed over as a download link"},{"name":"fileName","type":"string","required":false,"description":"The file name, echoed into the report only"},{"name":"language","type":"string","required":false,"description":"Language of the plain-language explanations: en (default) or de"},{"name":"pdfBase64","type":"string","required":false,"description":"A ZUGFeRD or Factur-X PDF, base64-encoded"},{"name":"xml","type":"string","required":false,"description":"The invoice XML as text"}],"outputs":[{"name":"acceptable","type":"boolean","required":true,"description":"The verdict: true when no ERROR-severity finding remains"},{"name":"businessRulesEvaluated","type":"boolean","required":true,"description":"False when a schema failure stopped the run, so an empty list is not a pass"},{"name":"errors","type":"integer","required":true,"description":null},{"name":"findings","type":"array","required":true,"description":null},{"name":"rulesetVersion","type":"string","required":true,"description":"The KoSIT rule set release that produced the verdict"},{"name":"scenario","type":"string|null","required":true,"description":"The rules that judged the document; null means nothing was checked"},{"name":"schemaValid","type":"boolean","required":true,"description":null},{"name":"warnings","type":"integer","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":200},{"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.","inputs":[{"name":"file","type":"object","required":false,"description":"An uploaded file, handed over as a download link"},{"name":"language","type":"string","required":false,"description":"Language of the plain-language explanations: en (default) or de"},{"name":"pdfBase64","type":"string","required":false,"description":"A ZUGFeRD or Factur-X PDF, base64-encoded"},{"name":"validate","type":"boolean","required":false,"description":"Also check the invoice against the KoSIT rules and return the verdict"},{"name":"xml","type":"string","required":false,"description":"The invoice XML as text"}],"outputs":[{"name":"businessProcess","type":"string|null","required":true,"description":"BT-23"},{"name":"documentKind","type":"string","required":true,"description":"UBL says so by its root element; in CII the type code (BT-3) decides"},{"name":"invoice","type":"object","required":true,"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`."},{"name":"missingForGeneration","type":"array","required":true,"description":"What generate_invoice would refuse in `invoice`, field by field; empty when ready"},{"name":"notMapped","type":"array","required":true,"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."},{"name":"profile","type":null,"required":true,"description":"The generate_invoice profile that declares exactly this BT-24; null for any other declaration"},{"name":"readyToGenerate","type":"boolean","required":true,"description":"Whether `invoice` passes generate_invoice's schema as it is"},{"name":"source","type":"object","required":true,"description":null},{"name":"specificationId","type":"string|null","required":true,"description":"BT-24, the rules the document declares"},{"name":"stated","type":"object","required":true,"description":null},{"name":"syntax","type":"string","required":true,"description":null},{"name":"validation","type":null,"required":true,"description":"With validate: true, the verdict as validate_invoice returns it; otherwise null"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":262},{"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.","inputs":[{"name":"invoice","type":"object","required":true,"description":null},{"name":"language","type":"string","required":false,"description":"Language of the plain-language explanations: en (default) or de"},{"name":"letterhead","type":"string","required":false,"description":"zugferd only: 'none' for NormAPI's standard layout instead of the account's letterhead"},{"name":"profile","type":"string","required":false,"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."},{"name":"syntax","type":"string","required":false,"description":"ubl or cii for XML, zugferd for the PDF/A-3 with the invoice embedded"}],"outputs":[{"name":"bytes","type":"integer","required":true,"description":null},{"name":"fileName","type":"string","required":true,"description":null},{"name":"letterhead","type":"string|null","required":true,"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"},{"name":"letterheadSkipped","type":"string|null","required":true,"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…"},{"name":"mimeType","type":"string","required":true,"description":null},{"name":"profile","type":"string","required":true,"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."},{"name":"rulesetVersion","type":"string|null","required":true,"description":"The rule set the document passed before it was returned"},{"name":"scenario","type":"string|null","required":true,"description":null},{"name":"syntax","type":"string","required":true,"description":null},{"name":"xml","type":"string","required":false,"description":"The XML document; absent for the ZUGFeRD PDF, which is the attached resource"}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":266},{"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.","inputs":[{"name":"code","type":"string","required":true,"description":"The rule code, e.g. BR-DE-15"},{"name":"language","type":"string","required":false,"description":"Language of the plain-language explanations: en (default) or de"}],"outputs":[{"name":"cause","type":"string","required":true,"description":null},{"name":"code","type":"string","required":true,"description":null},{"name":"fix","type":"string","required":true,"description":null},{"name":"language","type":"string","required":true,"description":null},{"name":"meaning","type":"string","required":true,"description":null},{"name":"url","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":130}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-05T04:33:13.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"none","label":"No attestation","reason":null,"reasonLabel":null,"discovery":null,"discoveryLabel":null,"sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":4,"partial":false,"deprecated":null,"stale":null,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-10-11","recent":[{"id":"chg_01a19fab-091d-79a0-a542-51bd3bba7d27","kind":"score.total_changed","summary":"Trust score (74 → 75)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-03","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a19fab-091d-79a0-a542-51bd3bba7d27"},{"id":"chg_01a19704-b84e-7f37-9d84-bf10193513d7","kind":"score.total_changed","summary":"Trust score (34 → 74)","materiality":"functional","direction":"improvement","scoreDelta":40,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a19704-b84e-7f37-9d84-bf10193513d7"},{"id":"chg_01a196ff-8170-78bd-b4a2-f1d10eee6eaa","kind":"package.version_changed","summary":"Package version (1.3.0 → 1.3.1)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a196ff-8170-78bd-b4a2-f1d10eee6eaa"},{"id":"chg_01a196ff-8170-735e-b6fa-eb807a72666c","kind":"check.unverifiable","summary":"Schema quality (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a196ff-8170-735e-b6fa-eb807a72666c"},{"id":"chg_01a196ff-8170-7d36-9a1f-8613be111031","kind":"score.total_changed","summary":"Trust score (74 → 34)","materiality":"functional","direction":"regression","scoreDelta":-40,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a196ff-8170-7d36-9a1f-8613be111031"},{"id":"chg_01a196ff-816d-782d-9cb4-88fb3cf53b53","kind":"check.unverifiable","summary":"Tool safety (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a196ff-816d-782d-9cb4-88fb3cf53b53"},{"id":"chg_01a196ff-816e-7af6-8d50-67a1347215a2","kind":"check.unverifiable","summary":"Stability (0.57 → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a196ff-816e-7af6-8d50-67a1347215a2"},{"id":"chg_01a196ff-816f-784e-b053-50cc4f2874f2","kind":"check.unverifiable","summary":"Capabilities (pass → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a196ff-816f-784e-b053-50cc4f2874f2"},{"id":"chg_01a196ff-816f-7e53-8bfb-08d1ca855be1","kind":"check.unverifiable","summary":"Tool coverage (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a196ff-816f-7e53-8bfb-08d1ca855be1"},{"id":"chg_01a1955c-bc37-79de-8ea3-fdc721ef9b0d","kind":"score.total_changed","summary":"Trust score (58 → 74)","materiality":"functional","direction":"improvement","scoreDelta":16,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a1955c-bc37-79de-8ea3-fdc721ef9b0d"},{"id":"chg_01a1955c-bc36-790f-9fce-d745df9d2d04","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a1955c-bc36-790f-9fce-d745df9d2d04"},{"id":"chg_01a19420-3998-7086-8d27-e823c6a612e2","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a19420-3998-7086-8d27-e823c6a612e2"},{"id":"chg_01a19420-399d-77e4-99b8-c52b9f5ae1ba","kind":"package.version_changed","summary":"Package version (1.2.1 → 1.3.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a19420-399d-77e4-99b8-c52b9f5ae1ba"},{"id":"chg_01a19420-399f-792e-b7c1-fc4e961c5706","kind":"score.total_changed","summary":"Trust score (73 → 58)","materiality":"functional","direction":"regression","scoreDelta":-15,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a19420-399f-792e-b7c1-fc4e961c5706"},{"id":"chg_01a1907f-a09a-78cb-bab9-953e3d0fdd6f","kind":"check.unverifiable","summary":"Security disclosure (fail → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-10-31","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a1907f-a09a-78cb-bab9-953e3d0fdd6f"},{"id":"chg_01a18b10-6b5e-72f6-a615-dd3af70e3985","kind":"score.total_changed","summary":"Trust score (72 → 73)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-10-30","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a18b10-6b5e-72f6-a615-dd3af70e3985"},{"id":"chg_01a1875b-f5bf-7cc7-9dee-f1e49033e4db","kind":"check.measure","summary":"Schema quality (273 → 231)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-10-29","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a1875b-f5bf-7cc7-9dee-f1e49033e4db"},{"id":"chg_01a1875b-f5bf-7728-9fc0-a966d6cf5d24","kind":"check.reverified","summary":"Schema quality (unverified → 100)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-10-29","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a1875b-f5bf-7728-9fc0-a966d6cf5d24"},{"id":"chg_01a1875b-f5c0-7209-8001-35ae088e5243","kind":"check.appeared","summary":"First check of Capabilities (pass)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-29","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a1875b-f5c0-7209-8001-35ae088e5243"},{"id":"chg_01a1875b-f5c0-7a7c-b2bc-d7da6a3fa077","kind":"check.measure","summary":"Schema quality (excellent → good)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-29","url":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp#chg-chg_01a1875b-f5c0-7a7c-b2bc-d7da6a3fa077"}],"truncated":true,"feedUrl":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp/changelog.json"},"links":{"html":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp","markdown":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp.md","changelogJson":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp/changelog.json","changelogRss":"https://verifymcp.io/servers/com-normapi-mcp/normapi-mcp.xml","external":[{"label":"npm package","href":"https://www.npmjs.com/package/@normapi/mcp"},{"label":"Socket report","href":"https://socket.dev/npm/package/@normapi/mcp"},{"label":"Website","href":"https://normapi.com/en/docs/mcp"}]}}