# finisma – ZUGFeRD e-invoices

> finisma – ZUGFeRD e-invoices is a freemium MCP server for finance and payments. Create and verify ZUGFeRD e-invoices and check VAT IDs and Peppol from an AI client. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://finisma.de/entwickler/connector
- **MCP Registry name:** de.finisma/finisma
- **Categories:** finance and payments
- **Listing updated:** 2026-11-16

## About

finisma's connector is a remote server for German e-invoicing. verify_zugferd checks a ZUGFeRD or Factur-X PDF for structure, EN 16931 rules and PDF/A-3 attachments and works without credentials. create_zugferd takes the visual invoice PDF plus structured EN 16931 data and produces the CII XML embedded in a PDF/A-3 file deterministically, without a language model.

For chat clients that cannot pass attachments reliably, request_upload_link issues a short-lived upload slot (real PDFs only, up to 25 MB, expiring after 20 minutes). extract_invoice then reads the PDF and returns invoice data plus a list of validation issues, marking uncertain fields so the user can correct them before create_zugferd runs again. Two preflight tools, check_vat_id and check_peppol_participant, query VIES live and look up Peppol reachability.

Tools carry tiers, OAuth scopes and rate limits (for example 30 per minute for verify, 10 for extract). Authentication is an API key or OAuth 2.1 bearer token, and free tools work without either under an IP-based limit. Without a subscription, create_zugferd costs one credit per invoice, or is free with an account but watermarked and capped at 5 a day by default. The same tools are exposed in the browser through WebMCP on finisma.de.

## Features

- **ZUGFeRD verification:** Checks Factur-X PDFs against structure, EN 16931 and PDF/A-3 rules.
- **Deterministic creation:** Builds CII XML embedded in PDF/A-3 without an LLM.
- **Invoice extraction:** Reads a PDF and flags uncertain fields for correction.
- **VAT ID check:** Queries VIES live; unavailable means no answer, not invalid.
- **Peppol lookup:** Checks via SML/SMP whether a partner is reachable on Peppol.
- **Upload slots:** Short-lived upload links for chat clients that cannot send base64.

## Good for

- Validate a received e-invoice PDF
- Generate a ZUGFeRD invoice from JSON data
- Fix extraction errors in a chat before issuing an invoice
- Preflight a customer's VAT ID and Peppol status before sending

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http finisma https://finisma.de/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://finisma.de/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "finisma": {
      "url": "https://finisma.de/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "finisma": {
      "type": "http",
      "url": "https://finisma.de/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "finisma": {
      "serverUrl": "https://finisma.de/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "finisma": {
      "type": "http",
      "url": "https://finisma.de/api/mcp"
    }
  }
}
```

## Tools

- `verify_zugferd`: Verify a ZUGFeRD or Factur-X PDF
- `create_zugferd`: Create a ZUGFeRD e-invoice from PDF and EN 16931 data
- `request_upload_link`: Get a short-lived upload slot for a PDF
- `extract_invoice`: Extract invoice data from a PDF and list validation issues
- `check_vat_id`: Check a VAT ID live via VIES
- `check_peppol_participant`: Check whether a partner is reachable on Peppol

## FAQ

### Do I need an account?

Not for the free tools such as verify_zugferd; those are limited per IP instead of per key.

### What does create_zugferd cost?

Without a subscription it uses one credit per invoice with no watermark, or is free with an account with a watermark and up to 5 invoices a day by default.

### How do I authenticate?

With an API key or an OAuth 2.1 bearer token, the same as the REST API.

### Is the invoice generated by an AI?

No for create_zugferd, which is deterministic; extract_invoice does use a language model.

### Is finisma – ZUGFeRD e-invoices free?

finisma – ZUGFeRD e-invoices has a free plan, with paid plans for more usage or features.

### How do I add finisma – ZUGFeRD e-invoices to Claude Code?

Run this command in your terminal: claude mcp add --transport http finisma https://finisma.de/api/mcp

### What are the best alternatives to finisma – ZUGFeRD e-invoices?

The closest alternatives to finisma – ZUGFeRD e-invoices are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/finisma-zugferd-e-invoices
