# ustidnr-mcp

Validate EU VAT IDs directly from your AI assistant. The only MCP server with qualifizierte Bestätigung (qualified confirmation) — the legally required proof for German businesses doing EU cross-bord…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add mavengence/ustidnr-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list mavengence/ustidnr-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get mavengence/ustidnr-mcp validate_ustidnr

# Call a tool
npx -y @smithery/cli@latest tool call mavengence/ustidnr-mcp validate_ustidnr '{}'
```

## Direct MCP Connection

Endpoint: `https://ustidnr-mcp--mavengence.run.tools`

## Tools (3)

- `validate_ustidnr` — Validiert eine EU USt-IdNr (Format + BZSt/VIES-Prüfung).
- `validate_batch` — Batch-Validierung mehrerer EU USt-IdNr (bis zu 100).
- `qualified_confirmation` — Qualifizierte Bestätigung nach §6a UStG (BZSt eVatR).

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get mavengence/ustidnr-mcp <tool-name>
```

## Resources

- `ustidnr://reference/eu-formats` — EU USt-IdNr-Formate nach Mitgliedstaat.
- `ustidnr://reference/bzst-response-codes` — BZSt eVatR Antwortcodes und deren Bedeutung.
- `ustidnr://compliance/paragraph-6a-ustg` — §6a UStG / §25d UStG Compliance-Leitfaden.
- `ustidnr://reference/check-digit-algorithm` — Prüfzifferalgorithmus für deutsche USt-IdNr.

## Prompts (8)

- `geschaeftspartner_pruefen` (partner_ustidnr) — Prüfe die USt-IdNr meines Geschäftspartners.
- `batch_validierung` (ustidnr_liste) — Validiere alle USt-IdNr in meiner Kundenliste.
- `qualifizierte_bestaetigung` (eigene_ustidnr, partner_ustidnr, firmenname, ort, plz, strasse) — Qualifizierte Bestätigung für innergemeinschaftliche Lieferung.
- `nachweispflicht_erklaerung` — Erkläre §6a UStG Nachweispflicht für innergemeinschaftliche Lieferungen.
- `eu_rechnungen_batch` — Batch-Validierung für EU-Rechnungen — monatlicher Workflow.
- `reverse_charge_pruefung` (partner_ustidnr) — Prüfe Voraussetzungen für Reverse-Charge-Verfahren.
- `einvoice_workflow` (partner_ustidnr) — Kompletter Workflow: USt-IdNr prüfen → Rechnung erstellen.
- `format_erklaerung` (laendercode) — Erkläre das USt-IdNr-Format für ein EU-Land.