de en es ja ko ru zh

Invoice Parser MCP

Name: Invoice Parser MCP
Author: knportal

by knportal

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Invoice Parser MCP

Analysieren Sie Rechnungen, Quittungen und Finanzdokumente in strukturiertes JSON — direkt aus Ihrem KI-Agenten.

License: MIT Version MCP

Gelistet auf: Glama · Smithery · mcp.so

Entwickelt für das Model Context Protocol. Unterstützt durch Claude Vision.

Funktionsweise

Extrahiert strukturierte Daten aus PDF-Rechnungen, gescannten Quittungen und Bilddateien. Keine Vorlagen, keine OCR-Konfiguration erforderlich — Claude Vision liest das Dokument und liefert sauberes JSON.

Related MCP server: kelnix-receipt-mcp-api

Tools

Tool	Beschreibung	Preis
`parse_invoice`	Vollständige Rechnungsanalyse (Anbieter, Einzelposten, Summen, Fälligkeitsdatum)	$0.05/Aufruf
`parse_receipt`	Analyse von Einzelhandelsquittungen (Händler, Artikel, Steuer, Zahlungsmethode)	$0.05/Aufruf
`extract_line_items`	Nur die spezifizierte Liste, sonst nichts	$0.01/Aufruf
`extract_totals`	Nur Zwischensumme, Steuer, Gesamtbetrag, Fälligkeitsdatum	$0.01/Aufruf
`validate_invoice`	Mathematische Validierung — prüft, ob die Einzelposten korrekt addiert wurden	$0.01/Aufruf
`export_to_csv`	Batch-Analyse mehrerer Dateien → Zusammenfassungs-CSV (max. 20)	$0.10/Aufruf

Tool-Referenz

`parse_invoice`

Vollständige Rechnungsanalyse. Extrahiert jedes strukturierte Feld aus einer Lieferantenrechnung.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`file_path`	string	Ja	Absoluter Pfad zur Rechnungs-PDF oder zum Bild (PNG, JPG, WEBP).
`api_key`	string	Nein*	Ihr InvoiceParser API-Schlüssel. Erhältlich unter plenitudo.ai.
`payment_proof`	string	Nein*	x402 Zahlungsnachweis (Base USDC Transaktions-Hash). Alternative zum `api_key`.

*Entweder api_key oder payment_proof muss angegeben werden.

Beispieleingabe

{
  "file_path": "/Users/me/documents/invoice_acme_jan2025.pdf",
  "api_key": "ip_free_abc123"
}

Beispielausgabe

{
  "ok": true,
  "document_type": "invoice",
  "vendor": {
    "name": "Acme Corp",
    "address": "123 Industrial Way, Austin TX 78701",
    "email": "billing@acme.com",
    "phone": "512-555-0100",
    "tax_id": "12-3456789"
  },
  "bill_to": {
    "name": "Jane Smith",
    "address": "456 Oak Ave, Boston MA 02101",
    "email": "jane@example.com"
  },
  "invoice_number": "INV-2025-0142",
  "invoice_date": "2025-01-15",
  "due_date": "2025-02-15",
  "payment_terms": "Net 30",
  "currency": "USD",
  "line_items": [
    {
      "description": "Software consulting — January",
      "quantity": 40,
      "unit_price": 175.0,
      "total": 7000.0,
      "tax_rate": 0.0
    }
  ],
  "subtotal": 7000.0,
  "discount": 0.0,
  "tax_amount": 560.0,
  "shipping": 0.0,
  "total": 7560.0,
  "amount_due": 7560.0,
  "notes": "Wire transfer preferred. See banking details on page 2.",
  "po_number": "PO-98765"
}

`parse_receipt`

Analysieren Sie eine Einzelhandels- oder Ausgabenquittung. Entwickelt für Point-of-Sale-Belege, Restaurantrechnungen und Spesenabrechnungsdokumente.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`file_path`	string	Ja	Absoluter Pfad zur Quittungs-PDF oder zum Bild (PNG, JPG, WEBP).
`api_key`	string	Nein*	Ihr InvoiceParser API-Schlüssel.
`payment_proof`	string	Nein*	x402 Zahlungsnachweis (Base USDC Transaktions-Hash).

Beispieleingabe

{
  "file_path": "/Users/me/receipts/coffee_shop_march1.jpg",
  "api_key": "ip_free_abc123"
}

Beispielausgabe

{
  "ok": true,
  "document_type": "receipt",
  "merchant": {
    "name": "Blue Bottle Coffee",
    "address": "300 Webster St, Oakland CA 94609",
    "phone": "510-555-0200",
    "website": "bluebottlecoffee.com"
  },
  "date": "2025-03-01",
  "time": "09:14",
  "receipt_number": "5541",
  "cashier": "Maria",
  "items": [
    { "name": "Latte (large)", "quantity": 1, "unit_price": 6.50, "total": 6.50, "sku": "", "category": "beverage" },
    { "name": "Croissant", "quantity": 1, "unit_price": 4.00, "total": 4.00, "sku": "", "category": "pastry" }
  ],
  "subtotal": 10.50,
  "discounts": 0.0,
  "tax": 0.84,
  "tip": 2.00,
  "total": 13.34,
  "currency": "USD",
  "payment_method": "Visa",
  "card_last_four": "4242",
  "transaction_id": "TXN-88821",
  "loyalty_points": null,
  "notes": ""
}

`extract_line_items`

Leichte Extraktion, die nur die spezifizierte Liste zurückgibt. Schneller und günstiger als parse_invoice, wenn Sie nur die Einzelposten benötigen.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`file_path`	string	Ja	Absoluter Pfad zur Rechnungs- oder Quittungs-PDF oder zum Bild.
`api_key`	string	Nein*	Ihr InvoiceParser API-Schlüssel.
`payment_proof`	string	Nein*	x402 Zahlungsnachweis (Base USDC Transaktions-Hash).

Beispielausgabe

{
  "ok": true,
  "line_items": [
    { "description": "Widget A (x10)", "quantity": 10, "unit_price": 12.00, "total": 120.00 },
    { "description": "Widget B (x5)",  "quantity": 5,  "unit_price": 24.00, "total": 120.00 }
  ],
  "item_count": 2
}

`extract_totals`

Extrahiert nur die finanzielle Zusammenfassung (Zwischensumme, Steuern, Gesamtbeträge, Fälligkeitsdatum), ohne Einzelposten oder Anbieterdetails zu analysieren.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`file_path`	string	Ja	Absoluter Pfad zur Rechnungs- oder Quittungs-PDF oder zum Bild.
`api_key`	string	Nein*	Ihr InvoiceParser API-Schlüssel.
`payment_proof`	string	Nein*	x402 Zahlungsnachweis (Base USDC Transaktions-Hash).

Beispielausgabe

{
  "ok": true,
  "currency": "USD",
  "subtotal": 240.00,
  "discount": 0.0,
  "tax_amount": 19.20,
  "tax_rate": 8.0,
  "shipping": 0.0,
  "tip": 0.0,
  "total": 259.20,
  "amount_due": 259.20,
  "invoice_date": "2025-01-15",
  "due_date": "2025-02-15"
}

`validate_invoice`

Tool zur mathematischen Validierung. Überprüft, ob die Summen der Einzelposten Menge × Einzelpreis entsprechen, ob die Zwischensumme mit der Summe der Einzelposten übereinstimmt, ob die Steuerberechnung konsistent ist und ob der Endbetrag korrekt ist. Erlaubt eine Rundungstoleranz von ±$0.02.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`file_path`	string	Ja	Absoluter Pfad zur Rechnungs-PDF oder zum Bild.
`api_key`	string	Nein*	Ihr InvoiceParser API-Schlüssel.
`payment_proof`	string	Nein*	x402 Zahlungsnachweis (Base USDC Transaktions-Hash).

Beispielausgabe — gültige Rechnung

{
  "ok": true,
  "valid": true,
  "issues": [],
  "summary": {
    "line_items_checked": 3,
    "subtotal": 450.00,
    "tax": 36.00,
    "total": 486.00,
    "currency": "USD"
  }
}

Beispielausgabe — ungültige Rechnung

{
  "ok": true,
  "valid": false,
  "issues": [
    {
      "field": "line_item_2_total",
      "expected": 120.00,
      "found": 100.00,
      "description": "quantity (10) × unit_price (12.00) = 120.00, but stated total is 100.00"
    }
  ],
  "summary": {
    "line_items_checked": 3,
    "subtotal": 340.00,
    "tax": 27.20,
    "total": 367.20,
    "currency": "USD"
  }
}

`export_to_csv`

Analysieren Sie bis zu 20 Rechnungen oder Quittungen im Batch und exportieren Sie eine Zusammenfassungs-CSV. Jede Zeile enthält: Dateiname, Dokumenttyp, Anbieter/Händler, Datum, Nummer, Zwischensumme, Steuer, Gesamtbetrag, Währung, Fälligkeitsdatum, Zahlungsmethode.

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`file_paths`	Array von Strings	Ja	Liste der absoluten Pfade zu Rechnungs-/Quittungs-PDFs oder Bildern. Maximal 20.
`output_path`	string	Ja	Absoluter Pfad, unter dem die CSV-Ausgabedatei gespeichert wird.
`api_key`	string	Nein*	Ihr InvoiceParser API-Schlüssel.
`payment_proof`	string	Nein*	x402 Zahlungsnachweis (Base USDC Transaktions-Hash).

Beispieleingabe

{
  "file_paths": [
    "/Users/me/invoices/jan2025.pdf",
    "/Users/me/invoices/feb2025.pdf",
    "/Users/me/receipts/expense_march.jpg"
  ],
  "output_path": "/Users/me/exports/q1_summary.csv",
  "api_key": "ip_free_abc123"
}

Beispielausgabe (JSON-Antwort)

{
  "ok": true,
  "output_path": "/Users/me/exports/q1_summary.csv",
  "rows_written": 3,
  "errors": []
}

CSV-Spalten: filename, document_type, vendor_merchant, date, number, subtotal, tax, total, currency, due_date, payment_method

Unterstützte Formate

PDF (Rechnungen, gescannte Dokumente)
PNG, JPG, WEBP (Fotos von Quittungen, Screenshots)

Authentifizierung

Kostenlose Stufe: 20 Analysen/Monat mit einem API-Schlüssel (erhältlich unter plenitudo.ai)

Pay-per-use (x402): Kein Konto erforderlich. Senden Sie USDC auf Base an die Wallet-Adresse und übergeben Sie den Transaktions-Hash als payment_proof.

{
  "error": "Payment required",
  "x402": {
    "network": "base",
    "token": "USDC",
    "recipient": "0x9053FeDC90c1BCB4a8Cf708DdB426aB02430d6ad",
    "amount_usdc": 0.05
  }
}

Verwendung (Claude Desktop / MCP-Client)

{
  "mcpServers": {
    "invoice-parser": {
      "url": "https://invoice-parser.plenitudo.ai/mcp?ref=readme"
    }
  }
}

Architektur

server.py          — MCP server (6 tools: parse_invoice, parse_receipt,
                     extract_line_items, extract_totals, validate_invoice,
                     export_to_csv)
auth.py            — API key validation + usage tracking (SQLite)
x402.py            — x402 micropayment verification (USDC on Base)
config.py          — Environment variable loading
worker.js          — Cloudflare Worker (remote proxy for MCP traffic)
data/keys.db       — API key store (created at runtime)
data/usage.db      — Monthly usage counters (created at runtime)
logs/              — Structured log files
tests/             — Unit tests (mock Vision API, no real documents needed)

Anfragefluss

AI agent (Claude Desktop, Cursor, etc.)
    │
    │  MCP tool call (JSON-RPC over HTTP)
    ▼
Cloudflare Worker (worker.js)        ← optional remote proxy
    │
    │  Forwards to Railway deployment
    ▼
server.py (FastMCP, streamable HTTP)
    │
    ├── auth.py              validates API key / x402 proof
    ├── x402.py              verifies USDC transaction on Base
    └── Anthropic API        Claude Vision reads the document
            │
            ▼
        structured JSON → returned to agent

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
`ANTHROPIC_API_KEY`	Ja	Anthropic API-Schlüssel für Claude Vision. Auf `maxproxy` für lokales Proxy-Routing setzen.
`ANTHROPIC_BASE_URL`	Nein	Überschreibt die Anthropic Basis-URL. Bei Verwendung von maxproxy lokal auf `http://localhost:3456` setzen. In Cloud-Deployments nicht setzen.
`CLAUDE_MODEL`	Nein	Claude Modell-ID. Standard ist `claude-3-5-sonnet-20241022`.
`INVOICEPARSER_DATA_DIR`	Nein	Verzeichnis für SQLite-Datenbanken. Standard ist `./data`.
`PORT`	Nein	HTTP-Port. Standard ist `8000`. Railway setzt dies automatisch.

Deployment (Railway)

Forken Sie dieses Repo
Verbinden mit Railway → Neues Projekt → Von GitHub bereitstellen
Umgebungsvariablen hinzufügen:
- ANTHROPIC_API_KEY — Ihr Anthropic API-Schlüssel
- INVOICEPARSER_DATA_DIR — /data
- STRIPE_WEBHOOK_SECRET — aus dem Stripe-Dashboard
- STRIPE_PRO_PRICE_ID — aus dem Stripe-Dashboard
Ein persistentes Volume unter /data hinzufügen
Bereitstellen

Lokal ausführen (optionales maxproxy-Routing)

Wenn Sie den Server auf derselben Maschine wie eine maxproxy-Instanz auf Port 3456 ausführen, können Sie Claude Vision-Aufrufe darüber leiten, anstatt die Anthropic API direkt aufzurufen:

ANTHROPIC_API_KEY=maxproxy
ANTHROPIC_BASE_URL=http://localhost:3456

Lassen Sie ANTHROPIC_BASE_URL in jedem Cloud/Railway-Deployment ungesetzt (oder leer) — diese Umgebungen können keinen lokalen Proxy erreichen.

Mitwirken & Sicherheit

CONTRIBUTING.md — Entwickler-Setup und PR-Richtlinien
SECURITY.md — Richtlinie zur verantwortungsvollen Offenlegung
CHANGELOG.md — Versionsverlauf

Lizenz

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessUnresponsive

Resources

Related MCP Connectors

Document to JSON – PDF Invoice/Statement/Contract Parser
io.github.fashionmascherine-svg
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
Finance AI & Machine Learning
28
https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp
Invoice & Receipt OCR Extractor to Excel
com.ranovam
Invoice and receipt extractor: reads PDF and image invoices/receipts with AI, pulling date…
Finance AI & Machine Learning Image & Video Processing
1
https://mcp.apify.com?tools=enezli/invoice-to-excel
Docs-to-JSON A
io.github.Alex-Dev-Web-C-DE
Convert documents to structured JSON (invoices, receipts, contracts) in 2 seconds
AI & Machine Learning Data Platforms
11
https://document-to-json-mcp.mcpize.run/mcp
parsedoc
fr.custom-digital-services
Agent-native document parsing: PDF, scans and FR/EU invoices to structured JSON or Markdown.
Research & Data
2
https://parsedoc.custom-digital-services.fr/api/mcp

Related MCP Servers

aifais-mcp-server
Developer Tools Knowledge & Memory Security
AIFAIS
F
license
B
quality
Not graded
maintenance
Headless document processing for AI agents. Invoice extraction, contract analysis, and Dutch business verification. Pay-per-use via X402 on Solana. No API keys needed.
Updated 10 months ago (2026-01-08 17:03 UTC)
10
1
-
kelnix-receipt-mcp-api
Finance Image & Video Processing App Automation
kelnixsolutions
A
license
Not graded
quality
B
maintenance
Turn any receipt into structured, accounting-ready JSON or clean Markdown with one API call. AI-powered vision extracts merchant, date, line items, tax, totals, and suggests GL accounts for instant bookkeeping. 50 free credits on signup.
Updated 3 months ago (2026-08-14 07:53 UTC)
MIT
document-to-json-mcp
Data Platforms AI & Machine Learning
fashionmascherine-svg
A
license
A
quality
D
maintenance
Convert PDFs to structured JSON. Extract invoices, bank statements, contracts, and more. Pay per call via x402 USDC.
Updated 4 months ago (2026-06-25 16:25 UTC)
5
8
MIT
InvoiceOracle
Finance Legal & Compliance
ToolOracle
F
license
Not graded
quality
C
maintenance
Enables AI agents to parse and analyze PDF invoices, including text, field, and table extraction, OCR for scanned documents, ZUGFeRD support, compliance validation, and batch processing via MCP.
Updated 6 months ago (2026-05-09 17:40 UTC)
-

Appeared in Searches

发票识别

Invoice Parser MCP

Funktionsweise

Tools

Tool-Referenz

parse_invoice

parse_receipt

extract_line_items

extract_totals

validate_invoice

export_to_csv

Unterstützte Formate

Authentifizierung

Verwendung (Claude Desktop / MCP-Client)

Architektur

Deployment (Railway)

Lokal ausführen (optionales maxproxy-Routing)

Mitwirken & Sicherheit

Lizenz

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

aifais-mcp-server

kelnix-receipt-mcp-api

document-to-json-mcp

InvoiceOracle

Appeared in Searches

`parse_invoice`

`parse_receipt`

`extract_line_items`

`extract_totals`

`validate_invoice`

`export_to_csv`