e-invoice-mcp 0.1.8

MCP Server for Fintom8 E-Invoicing services (Conversion, Validation, Correction)

Fintom8 E-Invoicing Agent (MCP)

The official Model Context Protocol (MCP) server for Fintom8.

This server acts as an intelligent bridge to the AI-driven Fintom8 E-Invoice Platform. It enables autonomous agents (like Claude) to validate, audit, and correct e-invoices against the latest European standards (EN16931) and Peppol regulations.

---

🚀 Features

• PDF to UBL Conversion: Use Gemini-powered AI to extract data from PDF invoices and generate compliant XML.
• Automated Validation: Instant checks against EN16931 and Peppol 3.0.20 rules.
• AI Correction: Automatically fix non-compliant XML invoices using iterative AI refinement.
• Production Ready: High performance with extended timeouts for heavy AI operations.

---

🛠️ Installation

The easiest way to use the server is to install it via pip:

pip install e-invoice-mcp

Run the Server

Once installed, you can start the server with:

e-invoice-mcp

---

🔑 AI Client Configuration

Claude Desktop (Action required)

To use these tools in Claude, add the following to your configuration file: File: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fintom8": {
      "command": "e-invoice-mcp"
    }
  }
}

---

📦 Included Tools

1. convert_pdf_to_invoice

Converts PDF invoices to structured UBL format.

• Args: pdf_path (path) or pdf_base64 (string).
• Output: JSON with UBL XML and metadata.

2. validate_invoice (Basic Validation)

Validates UBL/Peppol XML invoices against compliance rules.

• Args: xml_content (string) or xml_path (path).
• Output: Simple JSON report (is_valid, errors).

3. validate_invoice_v2 (Advanced Validation)

Deep validation with optional AI explanations.

• Args: xml_path (path), include_explanation (bool).
• Output: Detailed compliance report with AI insights.

3. correct_invoice_xml

AI-powered correction of invalid XML invoices.

• Args: xml_path (path), max_iterations (int).
• Output: Fixed XML content.

---

� Privacy & Security

This server acts as a thin client proxy. Data is processed on secure Fintom8 production servers and is not used for AI model training.

License: MIT Website: fintom8.com