Which integrations are available for this server?

Integrates with Stripe for payment processing, webhook handling, and Pro tier subscription management.

How do I use Invoice Parser MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Invoice Parser MCP extract the vendor, items, and total from invoice.pdf" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

Invoice Parser MCP

by knportal

Overview Schema Related Servers Score Discussions

Python

Remote

Invoice Parser MCP

Parse invoices, receipts, and financial documents into structured JSON — from your AI agent.

License: MIT Version MCP

Listed on: Glama · Smithery · mcp.so

Built for the Model Context Protocol. Powered by Claude Vision.

What it does

Extracts structured data from PDF invoices, scanned receipts, and image files. No templates, no OCR configuration — Claude Vision reads the document and returns clean JSON.

Related MCP server: kelnix-receipt-mcp-api

Tools

Tool	Description	Price
`parse_invoice`	Full invoice parsing (vendor, line items, totals, due date)	$0.05/call
`parse_receipt`	Retail receipt parsing (merchant, items, tax, payment method)	$0.05/call
`extract_line_items`	Just the itemized list, nothing else	$0.01/call
`extract_totals`	Just subtotal, tax, total, due date	$0.01/call
`validate_invoice`	Math validation — checks that line items add up	$0.01/call
`export_to_csv`	Batch parse multiple files → summary CSV (max 20)	$0.10/call

Tool Reference

`parse_invoice`

Full invoice parsing. Extracts every structured field from a vendor invoice.

Parameters

Parameter	Type	Required	Description
`file_path`	string	Yes	Absolute path to the invoice PDF or image (PNG, JPG, WEBP).
`api_key`	string	No*	Your InvoiceParser API key. Get one at plenitudo.ai.
`payment_proof`	string	No*	x402 payment proof (Base USDC tx hash). Alternative to `api_key`.

*Either api_key or payment_proof must be provided.

Example input

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

Example output

{
  "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`

Parse a retail or expense receipt. Designed for point-of-sale receipts, restaurant bills, and expense claim documents.

Parameters

Parameter	Type	Required	Description
`file_path`	string	Yes	Absolute path to the receipt PDF or image (PNG, JPG, WEBP).
`api_key`	string	No*	Your InvoiceParser API key.
`payment_proof`	string	No*	x402 payment proof (Base USDC tx hash).

Example input

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

Example output

{
  "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`

Lightweight extraction that returns only the itemized list. Faster and cheaper than parse_invoice when you only need the line items.

Parameters

Parameter	Type	Required	Description
`file_path`	string	Yes	Absolute path to the invoice or receipt PDF or image.
`api_key`	string	No*	Your InvoiceParser API key.
`payment_proof`	string	No*	x402 payment proof (Base USDC tx hash).

Example output

{
  "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`

Extract only the financial summary (subtotal, taxes, totals, due date) without parsing line items or vendor details.

Parameters

Parameter	Type	Required	Description
`file_path`	string	Yes	Absolute path to the invoice or receipt PDF or image.
`api_key`	string	No*	Your InvoiceParser API key.
`payment_proof`	string	No*	x402 payment proof (Base USDC tx hash).

Example output

{
  "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`

Math validation tool. Verifies that line item totals equal quantity × unit_price, that the subtotal matches the sum of line items, that the tax calculation is consistent, and that the final total reconciles. Allows ±$0.02 rounding tolerance.

Parameters

Parameter	Type	Required	Description
`file_path`	string	Yes	Absolute path to the invoice PDF or image.
`api_key`	string	No*	Your InvoiceParser API key.
`payment_proof`	string	No*	x402 payment proof (Base USDC tx hash).

Example output — valid invoice

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

Example output — invalid invoice

{
  "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`

Batch parse up to 20 invoices or receipts and export a summary CSV. Each row contains: filename, document type, vendor/merchant, date, number, subtotal, tax, total, currency, due date, payment method.

Parameters

Parameter	Type	Required	Description
`file_paths`	array of strings	Yes	List of absolute paths to invoice/receipt PDFs or images. Maximum 20.
`output_path`	string	Yes	Absolute path where the output CSV file will be saved.
`api_key`	string	No*	Your InvoiceParser API key.
`payment_proof`	string	No*	x402 payment proof (Base USDC tx hash).

Example input

{
  "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"
}

Example output (JSON response)

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

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

Supported formats

PDF (invoices, scanned documents)
PNG, JPG, WEBP (photos of receipts, screenshots)

Authentication

Free tier: 20 parses/month with an API key (get one at plenitudo.ai)

Pay-per-use (x402): No account needed. Send USDC on Base to the wallet address, pass the tx hash as payment_proof.

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

Usage (Claude Desktop / MCP client)

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

Architecture

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)

Request flow

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

Environment variables

Variable	Required	Description
`ANTHROPIC_API_KEY`	Yes	Anthropic API key for Claude Vision. Set to `maxproxy` for local proxy routing.
`ANTHROPIC_BASE_URL`	No	Override Anthropic base URL. Set to `http://localhost:3456` when using maxproxy locally. Leave unset in cloud deployments.
`CLAUDE_MODEL`	No	Claude model ID. Defaults to `claude-3-5-sonnet-20241022`.
`INVOICEPARSER_DATA_DIR`	No	Directory for SQLite databases. Defaults to `./data`.
`PORT`	No	HTTP port. Defaults to `8000`. Railway sets this automatically.

Deployment (Railway)

Fork this repo
Connect to Railway → New Project → Deploy from GitHub
Add environment variables:
- ANTHROPIC_API_KEY — your Anthropic API key
- INVOICEPARSER_DATA_DIR — /data
- STRIPE_WEBHOOK_SECRET — from Stripe dashboard
- STRIPE_PRO_PRICE_ID — from Stripe dashboard
Add a persistent volume at /data
Deploy

Running locally (optional maxproxy routing)

If you run the server on the same machine as a maxproxy instance on port 3456, you can route Claude Vision calls through it instead of hitting the Anthropic API directly:

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

Leave ANTHROPIC_BASE_URL unset (or empty) in any cloud/Railway deployment — those environments cannot reach a local proxy.

Contributing & Security

CONTRIBUTING.md — dev setup and PR guidelines
SECURITY.md — responsible disclosure policy
CHANGELOG.md — version history

License

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

aifais-mcp-server
Developer Tools Knowledge & Memory Security
AIFAIS
F
license
B
quality
-
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 7 months ago (2026-01-08 17:03 UTC)
10
1
kelnix-receipt-mcp-api
Finance Image & Video Processing App Automation
kelnixsolutions
A
license
-
quality
C
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 5 months ago (2026-03-13 06:00 UTC)
MIT
document-to-json-mcp
Data Platforms AI & Machine Learning
fashionmascherine-svg
A
license
A
quality
B
maintenance
Convert PDFs to structured JSON. Extract invoices, bank statements, contracts, and more. Pay per call via x402 USDC.
Updated a month ago (2026-06-25 16:25 UTC)
5
8
MIT
document-intelligence-server
Text Summarization Image & Video Processing AI & Machine Learning
KennyWayn3
A
license
-
quality
B
maintenance
Enables intelligent document processing by extracting text, classifying document types, and generating structured summaries from PDFs and images using vision LLMs.
Updated a month ago (2026-07-11 07:32 UTC)
MIT

View all related MCP servers

Related MCP Connectors

Document to JSON – PDF Invoice/Statement/Contract Parser
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
x402 JSON Repair
Pay-per-call JSON repair + JSON Schema validation for AI agents (USDC on Base, x402).
Receipt Extraction
AU GST/ABN receipt extraction — assigns entertainment/ITC tax codes per line, not just OCR.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/knportal/invoice-parser-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Invoice Parser MCP

What it does

Tools

Tool Reference

parse_invoice

parse_receipt

extract_line_items

extract_totals

validate_invoice

export_to_csv

Supported formats

Authentication

Usage (Claude Desktop / MCP client)

Architecture

Deployment (Railway)

Running locally (optional maxproxy routing)

Contributing & Security

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

aifais-mcp-server

kelnix-receipt-mcp-api

document-to-json-mcp

document-intelligence-server

Related MCP Connectors

Latest Blog Posts

MCP directory API

`parse_invoice`

`parse_receipt`

`extract_line_items`

`extract_totals`

`validate_invoice`

`export_to_csv`