csv2zugferd
NUGET · CSV2ZUGFERD
csv2zugferd setup assistant: drafts and checks the CSV to ZUGFeRD/Factur-X mapping, local via stdio
Available components
Last scanned (19 hours ago)
Scores higher than 47% of NuGet servers
Category Finance and Payments
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Build provenance not yet verified. View diagnostics → Unverified
- Clear OSI-approved license (Apache-2.0).Pass
- Actively maintained (last published 12 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability81
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1399 tokens (~174/item across 8 items; 5 tools + 3 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 5 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 7 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Checks we ran (14)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- License
- Maintenance
- Security disclosure
- Schema quality
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (2)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Provenance in Provenance & TransparencyBuild provenance not yet verified.
- Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 9 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 8 Nov 26 57
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed nuget/csv2zugferd@1.3.1
Provenance Inconclusive
We could not complete the check, so nothing is claimed either way. This is a gap on our side, not a finding about the package.
| Result | Inconclusive |
|---|---|
| Ecosystem | nuget |
| Reason | Signature present, unverified |
Signer
| Signed as | Repository signature, names nuget.org |
|---|---|
| Subject | CN=NuGet.org Repository by Microsoft,O=NuGet.org Repository by Microsoft,L=Redmond,ST=Washington,C=US |
| Issuer | CN=DigiCert Trusted G4 Code Signing RSA4096 SHA384 2021 CA1,O=DigiCert\, Inc.,C=US |
| Valid from | 23 Feb 2024 |
| Valid until | 18 May 2027 |
| Service index | https://api.nuget.org/v3/index.json |
| Owners | rillsoft |
Background: How many MCP packages publish verified provenance →
Dependencies 0 packages
| Packages resolved | 0 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
Registry declarations For information only
What the registry and the package's own manifest say about this version. The publisher or the registry writes these, nothing here is verified, and none of it affects the score.
| Repository | https://github.com/rillsoft/csv2zugferd |
|---|---|
| Repository type | git |
| Commit | 698fcdc5e7ca8f84331b20cf29472dca0cffdc62 |
| Project URL | https://zugferd-tools.de/docs/mcp-server/ |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
csv2zugferd_config_file_create Save configuration file ~210
Validates configYaml (it must deserialize as a csv2zugferd configuration) and writes it to configPath as UTF-8 without BOM. An existing file is replaced only with overwrite: true; otherwise the call is rejected with file_exists and nothing is written. Returns the full path, the size and the csv2zugferd CLI command that uses the saved file for production runs. Does not run the mapping (use csv2zugferd_invoice_get first) and does not create XML or PDF files.
| Name | Type | Req | Description |
|---|---|---|---|
| configPath | string | yes | Target file path, for example C:/invoices/config.yml. The directory must exist. |
| configYaml | string | yes | The YAML configuration to save (content of the file). |
| csvPath | string | – | Optional CSV path inserted into the returned CLI command instead of a placeholder. |
| overwrite | boolean | – | True replaces an existing file at configPath. Default false: an existing file is never touched (file_exists). |
| Name | Type | Req | Description |
|---|---|---|---|
| bytes | integer | yes | Size of the written file in bytes (UTF-8 without BOM). |
| cliCommand | string | yes | Complete csv2zugferd CLI command for a production run with this configuration; placeholders in angle brackets mark paths that were not given. |
| configPath | string | yes | Full path of the written file. |
No examples provided.
csv2zugferd_config_get Check configuration ~198
Loads a YAML configuration from configPath or configYaml and reports its structure: effective settings and modes, every mapped field with its sources, unknown keys (typos), values outside the allowed sets with the fallback the CLI would apply, and ignored or missing sections. With csvPath the referenced columns are compared with the CSV header (missing and unused columns). Does not read cell values and does not calculate totals; use csv2zugferd_invoice_get for a trial run. Read-only, writes no files.
| Name | Type | Req | Description |
|---|---|---|---|
| configPath | string | – | Path to an existing YAML configuration file. Use either configPath or configYaml, not both. |
| configYaml | string | – | YAML configuration as text (the content of config.yml). Use either configPath or configYaml, not both. |
| csvPath | string | – | Optional CSV file whose header is compared with the referenced columns (structural check, no cell values are read). |
| Name | Type | Req | Description |
|---|---|---|---|
| columnsMissing | array | – | Only with csvPath: referenced columns without any match in the header (case-insensitive), neither direct nor indexed. |
| columnsReferenced | array | yes | CSV column names the configuration can read in the effective mode (direct names; in columns mode also the indexed names built from columnPattern). |
| columnsUnused | array | – | Only with csvPath: header columns no mapping refers to. |
| csv | object | yes | Effective CSV settings. |
| invalidValues | array | yes | Configured values outside their value set (version, profile, format, modes, currency, country, unit code, tax codes, type codes, schemes). |
| lineItemsMode | string | yes | Effective line item mode after fallback. |
| mappedFields | array | yes | Every configured field mapping with its configured sources in resolution order. |
| source | string | yes | Where the configuration came from. |
| totalsMode | string | yes | Effective totals mode after fallback. |
| unknownKeys | array | yes | Keys in the YAML that no configuration key matches (typos); they are silently ignored by the CLI. |
| warnings | array | yes | Structural findings: ignored or missing sections for the chosen modes, fallbacks of version, profile and format. |
| zugferd | object | yes | Effective output settings after fallbacks (canonical spelling). |
No examples provided.
csv2zugferd_config_schema_get Get configuration reference ~168
Returns the reference of the csv2zugferd YAML configuration: a JSON Schema of every key with description, type, default and allowed values, plus semantics per key (effect, mode dependency, resolution order value > column > rules > default, fallback for unknown values). Use it before drafting a configuration; no README is needed. The complete reference is about 100 KB; pass section (for example mapping.lineItems) to get one subtree with its definitions. Does not check a concrete configuration (use csv2zugferd_config_get). Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| section | string | – | Optional configuration path to return only that subtree with the definitions it uses, for example zugferd, mapping.lineItems or mapping.paymentMeans. Semantics are filtered to the same subtree. |
| Name | Type | Req | Description |
|---|---|---|---|
| schema | – | yes | JSON Schema (Draft 2020-12) of the whole YAML configuration (or of the section) with descriptions, defaults and value sets; $defs holds the shared definitions used. |
| schemaVersion | string | yes | csv2zugferd version the schema was generated from. |
| section | string|null | yes | The section argument as given, or null for the complete reference. |
| semantics | array | yes | Effect, modes, resolution sources and value sets per configuration path (filtered to the section when given). |
No examples provided.
csv2zugferd_csv_header_get Read CSV header ~227
Reads the header row of a CSV file and returns the column names in file order plus the number of data rows. Optionally returns up to 3 sample rows (sampleRows, default 0) so the mapping can be drafted from real values. Does not validate a configuration (use csv2zugferd_config_get) and does not map an invoice (use csv2zugferd_invoice_get). Read-only, writes no files.
| Name | Type | Req | Description |
|---|---|---|---|
| csvPath | string | yes | Path to the CSV file on the local file system (absolute or relative to the server's working directory). |
| encoding | string | – | Text encoding of the file, for example UTF-8 or windows-1252. Same meaning as csv.encoding in the YAML configuration. |
| sampleRows | integer | – | Number of data rows to return as samples, 0 to 3. Default 0 returns no cell values, only the header. |
| separator | string | – | Column separator used in the file. Use "\t" for tab. Same meaning as csv.separator in the YAML configuration. |
| Name | Type | Req | Description |
|---|---|---|---|
| columnCount | integer | yes | Number of columns in the header row. |
| columns | array | yes | Column names from the header row in file order. |
| csvPath | string | yes | The csvPath argument as given. |
| encoding | string | yes | The encoding that was applied. |
| rowCount | integer | yes | Number of data rows after the header. |
| sampleRows | array | yes | Sample data rows, each as a list of cell values in column order. Empty unless sampleRows > 0. |
| separator | string | yes | The separator that was applied. |
No examples provided.
csv2zugferd_invoice_get Trial run invoice mapping ~352
Runs the real csv2zugferd mapping for one CSV file with the given configuration (configPath or configYaml) without writing any output file: reads the CSV, maps header, parties, line items and totals, builds the ZUGFeRD XML in memory and returns invoice number, type, totals, tax breakdown, warnings with codes and paths, and the XML size. includeLineItems and includeParties (default false) add details; pdfTemplatePath also embeds the XML into a temporary PDF copy to check format and template. Does not create the XML or PDF for production; that is done by the csv2zugferd CLI (csv2zugferd_config_file_create returns the command). Read-only for the user's files; a temporary PDF is created and deleted only with pdfTemplatePath.
| Name | Type | Req | Description |
|---|---|---|---|
| configPath | string | – | Path to an existing YAML configuration file. Use either configPath or configYaml, not both. |
| configYaml | string | – | YAML configuration as text (the content of config.yml). Use either configPath or configYaml, not both. |
| csvPath | string | yes | Path to the CSV file with the invoice data. |
| includeLineItems | boolean | – | True adds the mapped line items (name, quantity, unit, price, line total, tax rate) to the result. |
| includeParties | boolean | – | True adds seller and buyer (name, city, country) to the result. |
| pdfTemplatePath | string | – | Optional PDF template: the trial run also embeds the XML into a copy of this PDF in the temp directory (deleted afterwards) and reports its size, which checks zugferd.format and the template. |
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | yes | Currency code (BT-5). |
| format | string | yes | Effective XML syntax (applied in the PDF only). |
| invoiceDate | string | yes | Invoice date (BT-2) as yyyy-MM-dd; 0001-01-01 when the date could not be parsed. |
| invoiceNumber | string | yes | Invoice number (BT-1) as mapped. |
| lineItemCount | integer | yes | Line items in the invoice. |
| lineItems | array | – | Mapped line items; only with includeLineItems. |
| parties | object | – | Seller and buyer; only with includeParties. |
| pdfBytes | integer | – | Size of the generated PDF in bytes; only with pdfTemplatePath. |
| profile | string | yes | Effective ZUGFeRD profile as library name; a configured EN16931 is reported as Comfort (same profile). |
| rowCount | integer | yes | Data rows read from the CSV. |
| taxBreakdown | array | yes | VAT breakdown per rate and category (BG-23). |
| totals | object | yes | Document totals (BG-22). |
| typeCode | string | yes | Invoice type code (BT-3), for example 380. |
| version | string | yes | Effective ZUGFeRD version. |
| warnings | array | yes | All findings of the run: document checks, fallbacks, unparsable values, ignored or missing sections. |
| xmlBytes | integer | yes | Size of the generated XML in bytes. |
No examples provided.
How do I install the csv2zugferd MCP server?
csv2zugferd runs locally as a NuGet package, launched with dnx csv2zugferd@1.3.1 --yes -- mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.
nuget · csv2zugferd
claude mcp add de-zugferd-tools-csv2zugferd -- dnx csv2zugferd@1.3.1 --yes -- mcp
What is the csv2zugferd MCP server?
csv2zugferd is an MCP server listed in the public MCP registry as de.zugferd-tools/csv2zugferd. csv2zugferd setup assistant: drafts and checks the CSV to ZUGFeRD/Factur-X mapping, local via stdio. This page covers its NuGet package (csv2zugferd).
Is the csv2zugferd MCP server safe to use?
csv2zugferd scores 72 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the csv2zugferd MCP server expose?
csv2zugferd exposes 5 tools: csv2zugferd_config_file_create, csv2zugferd_config_get, csv2zugferd_config_schema_get, csv2zugferd_csv_header_get, csv2zugferd_invoice_get. Their descriptions and schemas cost roughly 1,155 tokens of context every time the server is loaded.
Is the csv2zugferd MCP server still maintained?
csv2zugferd is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the csv2zugferd MCP server under?
csv2zugferd declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the csv2zugferd MCP server?
VerifyMCP ran 14 checks on csv2zugferd, covering Malware scan, Known CVEs, Install scripts, Dependency health and 10 more. 2 items could not be completed, a gap on our side rather than a finding about csv2zugferd: Provenance and Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to a NuGet package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.