home / mcp / invapi mcp server

Invapi MCP Server

Provides an MCP server to convert, validate, and extract invoices in UBL, CII, ZUGFeRD, Excel, and more.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "invapi-org-invapi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@invapi/mcp-server"
      ],
      "env": {
        "INVAPI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run the Invapi MCP server locally or within an integration to convert, validate, and extract invoices across multiple formats such as UBL, CII, ZUGFeRD, and Excel, enabling automated invoice processing and data extraction workflows.

How to use

Set up your MCP client to connect to the Invapi MCP server using the provided command configuration. You will typically run the MCP server via a package runner, passing your API key for authentication. Once running, you can convert, validate, and extract invoices by invoking the server through your MCP client and selecting the desired tool.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Install the MCP server package globally so you can access the command from any terminal.

npm install -g @invapi/mcp-server

Configuration and usage notes

To run the MCP server with your API key, you will provide the API key as an environment variable when launching the MCP client configuration.

{
  "mcpServers": {
    "invapi": {
      "command": "npx",
      "args": ["-y", "@invapi/mcp-server"],
      "env": {
        "INVAPI_API_KEY": "your-api-key"
      }
    }
  }
}

Additional usage guidance

You can also configure your Claude integration to add the MCP server by using the following pattern, substituting your API key where indicated. This enables Claude to route invoice data through the Invapi MCP server during processing.

claude mcp add -e INVAPI_API_KEY=xxx invapi -- npx @invapi/mcp-server

Available tools

invapi_convert_json_to_ubl

Convert a JSON invoice to UBL XML.

invapi_convert_json_to_cii

Convert a JSON invoice to CII XML.

invapi_convert_ubl_to_json

Convert UBL XML to a JSON invoice.

invapi_convert_cii_to_json

Convert CII XML to a JSON invoice.

invapi_convert_json_to_xlsx

Convert JSON invoices to an Excel file.

invapi_create_zugferd_pdf

Create a ZUGFeRD PDF from a PDF and JSON invoice.

invapi_convert_zugferd_to_json

Convert a ZUGFeRD PDF to a JSON invoice.

invapi_validate_ubl

Validate UBL XML against EN 16931 (XRechnung 3.0.2).

invapi_validate_cii

Validate CII XML against EN 16931 (XRechnung 3.0.2).

invapi_validate_xml

Validate XML with auto-detected format.

invapi_extract_invoice

Extract structured invoice data from a PDF or image.

invapi_extract_qr

Extract QR code data from an image.

invapi_get_user

Retrieve account info and remaining API credits.

invapi_batch_convert

Run up to 100 conversion operations in a single request.