rechnungsapi-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Finbc GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# rechnungsapi-mcp
+
+MCP (Model Context Protocol) server for [RechnungsAPI](https://rechnungsapi.de) — lets Claude and other MCP-compatible AI agents create, validate, and analyze ZUGFeRD and X-Invoice e-invoices directly from a conversation.
+
+Built on [`rechnungsapi-sdk`](https://github.com/Rechnungsapi/rechnungsapi-sdk).
+
+## Setup
+
+Get your API token from the [RechnungsAPI dashboard](https://rechnungsapi.de), then add the server to your MCP client's config.
+
+**Claude Code** (`.mcp.json` in your project, or via `claude mcp add`):
+
+```json
+{
+  "mcpServers": {
+    "rechnungsapi": {
+      "command": "npx",
+      "args": ["-y", "rechnungsapi-mcp"],
+      "env": {
+        "RECHNUNGSAPI_TOKEN": "your-api-token"
+      }
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`): same `mcpServers` entry as above.
+
+### Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `RECHNUNGSAPI_TOKEN` | Yes | Your RechnungsAPI Bearer token |
+| `RECHNUNGSAPI_BASE_URL` | No | Override the gateway base URL (e.g. for a sandbox environment) |
+| `RECHNUNGSAPI_V2_BASE_URL` | No | Override the v2 analyzer host |
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `create_zugferd_invoice` | Create a ZUGFeRD PDF/A-3 from structured invoice JSON + a visual PDF |
+| `create_xinvoice` | Create an X-Invoice (XRechnung/UBL) XML from structured invoice JSON |
+| `create_zugferd_pdf` | Embed an existing X-Invoice XML into a visual PDF |
+| `extract_xinvoice_from_zugferd` | Extract the embedded XRechnung XML from a ZUGFeRD PDF as JSON |
+| `validate_xinvoice_xml` | Validate an X-Invoice XML against schema and business rules |
+| `validate_zugferd_pdf` | Validate a ZUGFeRD PDF's embedded XML |
+| `analyze_pdf_invoice` | Extract structured invoice JSON from a scanned/PDF invoice |
+| `analyze_pdf_invoice_async_submit` / `analyze_pdf_invoice_async_status` | Async analysis for large files |
+| `create_zugferd_from_pdf` | Convert a PDF/scan directly into a validated ZUGFeRD PDF |
+
+## Development
+
+```bash
+yarn install
+yarn typecheck
+yarn build
+```
+
+Test locally with the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
+
+```bash
+RECHNUNGSAPI_TOKEN=your-token yarn inspect
+```
+
+> **Note:** `@modelcontextprotocol/sdk` is pinned to `1.22.0` (not `^1.x`). Versions ≥1.23.0 introduced a Zod v3/v4 compatibility layer that currently triggers a `TS2589: Type instantiation is excessively deep` compiler error with `registerTool` (see [modelcontextprotocol/typescript-sdk#1180](https://github.com/modelcontextprotocol/typescript-sdk/issues/1180) and [#1423](https://github.com/modelcontextprotocol/typescript-sdk/issues/1423)). Re-evaluate this pin once that's fixed upstream.
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { RechnungsApiClient as RechnungsApiClient2 } from "rechnungsapi-sdk";
+
+// src/config.ts
+function loadConfigFromEnv() {
+  const apiToken = process.env.RECHNUNGSAPI_TOKEN;
+  if (!apiToken) {
+    throw new Error(
+      `RECHNUNGSAPI_TOKEN environment variable is required. Get your API token from the RechnungsAPI dashboard and set it in your MCP client's server config (e.g. Claude Desktop/Code's mcp.json under "env").`
+    );
+  }
+  return {
+    apiToken,
+    baseUrl: process.env.RECHNUNGSAPI_BASE_URL,
+    v2BaseUrl: process.env.RECHNUNGSAPI_V2_BASE_URL
+  };
+}
+
+// src/tools.ts
+import { RechnungsApiError } from "rechnungsapi-sdk";
+import { z } from "zod";
+var invoiceJsonSchema = z.any().describe("Structured invoice data (line items, parties, totals, etc.) as defined by the RechnungsAPI invoice schema");
+var transportSchema = z.any().optional().describe("Optional delivery/transport metadata (e.g. email delivery options)");
+async function asToolResult(fn) {
+  try {
+    const result = await fn();
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  } catch (error) {
+    if (error instanceof RechnungsApiError) {
+      return {
+        isError: true,
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ status: error.status, message: error.message, body: error.body }, null, 2)
+          }
+        ]
+      };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return { isError: true, content: [{ type: "text", text: message }] };
+  }
+}
+function registerTools(server, client) {
+  server.registerTool(
+    "create_zugferd_invoice",
+    {
+      title: "Create ZUGFeRD invoice",
+      description: "Create a ZUGFeRD PDF/A-3 e-invoice (visual PDF with embedded XRechnung XML) from structured invoice JSON plus a visual PDF template.",
+      inputSchema: {
+        invoice: invoiceJsonSchema,
+        invoicePdf64: z.string().describe("Base64-encoded visual PDF the XML will be embedded into"),
+        transport: transportSchema
+      }
+    },
+    async ({ invoice, invoicePdf64, transport }) => asToolResult(() => client.createZugferdFromJson(invoice, invoicePdf64, { transport }))
+  );
+  server.registerTool(
+    "create_xinvoice",
+    {
+      title: "Create X-Invoice (XRechnung/UBL)",
+      description: "Create an X-Invoice (XRechnung/UBL) XML document from structured invoice JSON.",
+      inputSchema: {
+        invoice: invoiceJsonSchema,
+        transport: transportSchema
+      }
+    },
+    async ({ invoice, transport }) => asToolResult(() => client.createXInvoiceFromJson(invoice, { transport }))
+  );
+  server.registerTool(
+    "create_zugferd_pdf",
+    {
+      title: "Embed X-Invoice XML into a PDF",
+      description: "Embed an existing X-Invoice XML document into a visual PDF to produce a ZUGFeRD PDF.",
+      inputSchema: {
+        invoicePdf64: z.string().describe("Base64-encoded visual PDF"),
+        xInvoiceXml: z.string().describe("X-Invoice XML to embed")
+      }
+    },
+    async ({ invoicePdf64, xInvoiceXml }) => asToolResult(() => client.createZugferdPdf(invoicePdf64, xInvoiceXml))
+  );
+  server.registerTool(
+    "extract_xinvoice_from_zugferd",
+    {
+      title: "Extract X-Invoice from ZUGFeRD PDF",
+      description: "Extract the embedded XRechnung XML from a ZUGFeRD PDF and return it as structured JSON.",
+      inputSchema: {
+        zugferd64: z.string().describe("Base64-encoded ZUGFeRD PDF")
+      }
+    },
+    async ({ zugferd64 }) => asToolResult(() => client.extractXInvoiceFromZugferd(zugferd64))
+  );
+  server.registerTool(
+    "validate_xinvoice_xml",
+    {
+      title: "Validate X-Invoice XML",
+      description: "Validate an X-Invoice (XRechnung/UBL) XML document against schema and business rules.",
+      inputSchema: {
+        xml: z.string().describe("The X-Invoice XML content to validate")
+      }
+    },
+    async ({ xml }) => asToolResult(() => client.validateXInvoiceXml(xml))
+  );
+  server.registerTool(
+    "validate_zugferd_pdf",
+    {
+      title: "Validate ZUGFeRD PDF",
+      description: "Validate a ZUGFeRD PDF's embedded XML content.",
+      inputSchema: {
+        zugferdFile64: z.string().describe("Base64-encoded ZUGFeRD PDF"),
+        comparePDF2XML: z.boolean().optional().describe("Also cross-check the embedded XML against the visual PDF content")
+      }
+    },
+    async ({ zugferdFile64, comparePDF2XML }) => asToolResult(() => client.validateZugferdPdf(zugferdFile64, { comparePDF2XML }))
+  );
+  server.registerTool(
+    "analyze_pdf_invoice",
+    {
+      title: "Analyze a PDF/scanned invoice",
+      description: "Extract structured invoice JSON from a scanned or digital PDF/PNG/JPEG/TIFF invoice using the high-accuracy analyzer.",
+      inputSchema: {
+        pdfBase64: z.string().describe("Base64-encoded PDF, PNG, JPEG, or TIFF invoice"),
+        withLineItems: z.boolean().optional().describe("Also extract individual line items")
+      }
+    },
+    async ({ pdfBase64, withLineItems }) => asToolResult(() => client.analyzePdfInvoiceV2(pdfBase64, withLineItems ?? false))
+  );
+  server.registerTool(
+    "analyze_pdf_invoice_async_submit",
+    {
+      title: "Submit a large PDF invoice for async analysis",
+      description: "Submit a large scanned/PDF invoice for asynchronous analysis (for files too large for the synchronous analyzer). Returns a job_id \u2014 poll it with analyze_pdf_invoice_async_status.",
+      inputSchema: {
+        pdfBase64: z.string().describe("Base64-encoded PDF, PNG, JPEG, or TIFF invoice"),
+        withLineItems: z.boolean().optional().describe("Also extract individual line items")
+      }
+    },
+    async ({ pdfBase64, withLineItems }) => asToolResult(() => client.analyzePdfInvoiceAsync(pdfBase64, withLineItems))
+  );
+  server.registerTool(
+    "analyze_pdf_invoice_async_status",
+    {
+      title: "Check async PDF analysis status",
+      description: "Poll the status of an asynchronous PDF invoice analysis job submitted via analyze_pdf_invoice_async_submit.",
+      inputSchema: {
+        jobId: z.string().describe("The job_id returned by analyze_pdf_invoice_async_submit")
+      }
+    },
+    async ({ jobId }) => asToolResult(() => client.getAnalysisStatus(jobId))
+  );
+  server.registerTool(
+    "create_zugferd_from_pdf",
+    {
+      title: "Convert a PDF/scan directly into a ZUGFeRD PDF",
+      description: "Convert a PDF or scanned image invoice directly into a validated ZUGFeRD PDF/A-3 in one call (analyzes, validates, and embeds in a single step).",
+      inputSchema: {
+        pdfBase64: z.string().describe("Base64-encoded PDF, PNG, JPEG, or TIFF invoice"),
+        fileName: z.string().optional().describe("Original filename, used to name the resulting PDF")
+      }
+    },
+    async ({ pdfBase64, fileName }) => asToolResult(() => client.createZugferdFromPdf(pdfBase64, fileName))
+  );
+}
+
+// src/index.ts
+async function main() {
+  const config = loadConfigFromEnv();
+  const client = new RechnungsApiClient2(config);
+  const server = new McpServer({ name: "rechnungsapi-mcp", version: "0.1.0" });
+  registerTools(server, client);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((error) => {
+  console.error("rechnungsapi-mcp failed to start:", error instanceof Error ? error.message : error);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/tools.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { RechnungsApiClient } from \"rechnungsapi-sdk\"\nimport { loadConfigFromEnv } from \"./config.js\"\nimport { registerTools } from \"./tools.js\"\n\nasync function main() {\n  const config = loadConfigFromEnv()\n  const client = new RechnungsApiClient(config)\n\n  const server = new McpServer({ name: \"rechnungsapi-mcp\", version: \"0.1.0\" })\n  registerTools(server, client)\n\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch((error) => {\n  console.error(\"rechnungsapi-mcp failed to start:\", error instanceof Error ? error.message : error)\n  process.exit(1)\n})\n","export interface RechnungsApiMcpConfig {\n  apiToken: string\n  baseUrl?: string\n  v2BaseUrl?: string\n}\n\nexport function loadConfigFromEnv(): RechnungsApiMcpConfig {\n  const apiToken = process.env.RECHNUNGSAPI_TOKEN\n  if (!apiToken) {\n    throw new Error(\n      \"RECHNUNGSAPI_TOKEN environment variable is required. Get your API token from the RechnungsAPI dashboard \" +\n        \"and set it in your MCP client's server config (e.g. Claude Desktop/Code's mcp.json under \\\"env\\\").\",\n    )\n  }\n  return {\n    apiToken,\n    baseUrl: process.env.RECHNUNGSAPI_BASE_URL,\n    v2BaseUrl: process.env.RECHNUNGSAPI_V2_BASE_URL,\n  }\n}\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { RechnungsApiClient, RechnungsApiError } from \"rechnungsapi-sdk\"\nimport { z } from \"zod\"\n\nconst invoiceJsonSchema = z\n  .any()\n  .describe(\"Structured invoice data (line items, parties, totals, etc.) as defined by the RechnungsAPI invoice schema\")\n\nconst transportSchema = z\n  .any()\n  .optional()\n  .describe(\"Optional delivery/transport metadata (e.g. email delivery options)\")\n\n/** Wraps a client call so thrown RechnungsApiError/generic errors become MCP tool errors instead of crashing the server. */\nasync function asToolResult(fn: () => Promise<unknown>) {\n  try {\n    const result = await fn()\n    return { content: [{ type: \"text\" as const, text: JSON.stringify(result, null, 2) }] }\n  } catch (error) {\n    if (error instanceof RechnungsApiError) {\n      return {\n        isError: true,\n        content: [\n          {\n            type: \"text\" as const,\n            text: JSON.stringify({ status: error.status, message: error.message, body: error.body }, null, 2),\n          },\n        ],\n      }\n    }\n    const message = error instanceof Error ? error.message : String(error)\n    return { isError: true, content: [{ type: \"text\" as const, text: message }] }\n  }\n}\n\nexport function registerTools(server: McpServer, client: RechnungsApiClient): void {\n  server.registerTool(\n    \"create_zugferd_invoice\",\n    {\n      title: \"Create ZUGFeRD invoice\",\n      description:\n        \"Create a ZUGFeRD PDF/A-3 e-invoice (visual PDF with embedded XRechnung XML) from structured invoice JSON plus a visual PDF template.\",\n      inputSchema: {\n        invoice: invoiceJsonSchema,\n        invoicePdf64: z.string().describe(\"Base64-encoded visual PDF the XML will be embedded into\"),\n        transport: transportSchema,\n      },\n    },\n    async ({ invoice, invoicePdf64, transport }) =>\n      asToolResult(() => client.createZugferdFromJson(invoice, invoicePdf64, { transport })),\n  )\n\n  server.registerTool(\n    \"create_xinvoice\",\n    {\n      title: \"Create X-Invoice (XRechnung/UBL)\",\n      description: \"Create an X-Invoice (XRechnung/UBL) XML document from structured invoice JSON.\",\n      inputSchema: {\n        invoice: invoiceJsonSchema,\n        transport: transportSchema,\n      },\n    },\n    async ({ invoice, transport }) => asToolResult(() => client.createXInvoiceFromJson(invoice, { transport })),\n  )\n\n  server.registerTool(\n    \"create_zugferd_pdf\",\n    {\n      title: \"Embed X-Invoice XML into a PDF\",\n      description: \"Embed an existing X-Invoice XML document into a visual PDF to produce a ZUGFeRD PDF.\",\n      inputSchema: {\n        invoicePdf64: z.string().describe(\"Base64-encoded visual PDF\"),\n        xInvoiceXml: z.string().describe(\"X-Invoice XML to embed\"),\n      },\n    },\n    async ({ invoicePdf64, xInvoiceXml }) => asToolResult(() => client.createZugferdPdf(invoicePdf64, xInvoiceXml)),\n  )\n\n  server.registerTool(\n    \"extract_xinvoice_from_zugferd\",\n    {\n      title: \"Extract X-Invoice from ZUGFeRD PDF\",\n      description: \"Extract the embedded XRechnung XML from a ZUGFeRD PDF and return it as structured JSON.\",\n      inputSchema: {\n        zugferd64: z.string().describe(\"Base64-encoded ZUGFeRD PDF\"),\n      },\n    },\n    async ({ zugferd64 }) => asToolResult(() => client.extractXInvoiceFromZugferd(zugferd64)),\n  )\n\n  server.registerTool(\n    \"validate_xinvoice_xml\",\n    {\n      title: \"Validate X-Invoice XML\",\n      description: \"Validate an X-Invoice (XRechnung/UBL) XML document against schema and business rules.\",\n      inputSchema: {\n        xml: z.string().describe(\"The X-Invoice XML content to validate\"),\n      },\n    },\n    async ({ xml }) => asToolResult(() => client.validateXInvoiceXml(xml)),\n  )\n\n  server.registerTool(\n    \"validate_zugferd_pdf\",\n    {\n      title: \"Validate ZUGFeRD PDF\",\n      description: \"Validate a ZUGFeRD PDF's embedded XML content.\",\n      inputSchema: {\n        zugferdFile64: z.string().describe(\"Base64-encoded ZUGFeRD PDF\"),\n        comparePDF2XML: z.boolean().optional().describe(\"Also cross-check the embedded XML against the visual PDF content\"),\n      },\n    },\n    async ({ zugferdFile64, comparePDF2XML }) =>\n      asToolResult(() => client.validateZugferdPdf(zugferdFile64, { comparePDF2XML })),\n  )\n\n  server.registerTool(\n    \"analyze_pdf_invoice\",\n    {\n      title: \"Analyze a PDF/scanned invoice\",\n      description:\n        \"Extract structured invoice JSON from a scanned or digital PDF/PNG/JPEG/TIFF invoice using the high-accuracy analyzer.\",\n      inputSchema: {\n        pdfBase64: z.string().describe(\"Base64-encoded PDF, PNG, JPEG, or TIFF invoice\"),\n        withLineItems: z.boolean().optional().describe(\"Also extract individual line items\"),\n      },\n    },\n    async ({ pdfBase64, withLineItems }) =>\n      asToolResult(() => client.analyzePdfInvoiceV2(pdfBase64, withLineItems ?? false)),\n  )\n\n  server.registerTool(\n    \"analyze_pdf_invoice_async_submit\",\n    {\n      title: \"Submit a large PDF invoice for async analysis\",\n      description:\n        \"Submit a large scanned/PDF invoice for asynchronous analysis (for files too large for the synchronous analyzer). \" +\n        \"Returns a job_id — poll it with analyze_pdf_invoice_async_status.\",\n      inputSchema: {\n        pdfBase64: z.string().describe(\"Base64-encoded PDF, PNG, JPEG, or TIFF invoice\"),\n        withLineItems: z.boolean().optional().describe(\"Also extract individual line items\"),\n      },\n    },\n    async ({ pdfBase64, withLineItems }) =>\n      asToolResult(() => client.analyzePdfInvoiceAsync(pdfBase64, withLineItems)),\n  )\n\n  server.registerTool(\n    \"analyze_pdf_invoice_async_status\",\n    {\n      title: \"Check async PDF analysis status\",\n      description: \"Poll the status of an asynchronous PDF invoice analysis job submitted via analyze_pdf_invoice_async_submit.\",\n      inputSchema: {\n        jobId: z.string().describe(\"The job_id returned by analyze_pdf_invoice_async_submit\"),\n      },\n    },\n    async ({ jobId }) => asToolResult(() => client.getAnalysisStatus(jobId)),\n  )\n\n  server.registerTool(\n    \"create_zugferd_from_pdf\",\n    {\n      title: \"Convert a PDF/scan directly into a ZUGFeRD PDF\",\n      description:\n        \"Convert a PDF or scanned image invoice directly into a validated ZUGFeRD PDF/A-3 in one call \" +\n        \"(analyzes, validates, and embeds in a single step).\",\n      inputSchema: {\n        pdfBase64: z.string().describe(\"Base64-encoded PDF, PNG, JPEG, or TIFF invoice\"),\n        fileName: z.string().optional().describe(\"Original filename, used to name the resulting PDF\"),\n      },\n    },\n    async ({ pdfBase64, fileName }) => asToolResult(() => client.createZugferdFromPdf(pdfBase64, fileName)),\n  )\n}\n"],"mappings":"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","names":["RechnungsApiClient","RechnungsApiClient"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "rechnungsapi-mcp",
+  "version": "0.1.0",
+  "description": "MCP (Model Context Protocol) server for RechnungsAPI — lets AI agents create, validate, and analyze ZUGFeRD and X-Invoice e-invoices.",
+  "license": "MIT",
+  "author": "Finbc GmbH <support@rechnungsapi.de>",
+  "homepage": "https://rechnungsapi.de",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rechnungsapi/rechnungsapi-mcp.git"
+  },
+  "keywords": ["mcp", "model-context-protocol", "rechnungsapi", "zugferd", "xinvoice", "e-invoice"],
+  "type": "module",
+  "bin": {
+    "rechnungsapi-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.22.0",
+    "rechnungsapi-sdk": "^0.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}