Invoice Intelligence MCP Server

Một máy chủ MCP trả phí dành cho xử lý hóa đơn. Ba công cụ: trích xuất dữ liệu có cấu trúc từ bất kỳ hóa đơn nào (văn bản dán, URL hoặc PDF), xác thực hóa đơn đã trích xuất về tính đầy đủ và chính xác toán học, và phân loại chi phí vào một danh mục kế toán kèm mã tài khoản danh nghĩa được đề xuất và cờ khả năng khấu trừ thuế. Định giá từ $0,005 đến $0,01 mỗi lần gọi, thanh toán bằng USDC trên Base qua x402. Không yêu cầu khóa API.

GitHub

Tài liệu

Invoice Intelligence MCP

A paid MCP service that extracts, validates, and categorises invoices. Accepts pasted text, public URLs, or base64-encoded PDFs. Powered by x402 payments on Base mainnet.

Quick start

cd invoice-intelligence-mcp
npm install
cp .env.example .env
npm run dev        # http://localhost:3101
npm run test:run
npm run build

Tools

extract_invoice

Extract structured data from any invoice.

Input (one required):

  • text — pasted invoice text
  • url — public URL of invoice page or PDF
  • pdf_base64 — PDF encoded as base64

Output: vendor, client, invoice number, dates, line items, subtotal, VAT, total, bank details, payment terms, confidence score.

Price: $0.01

validate_invoice

Check an extracted invoice for completeness and mathematical accuracy.

Input: invoice — the output object from extract_invoice

Output: valid boolean, list of issues with severity, recalculated totals, totals_match flag.

Price: $0.005

categorise_expense

Classify an invoice into an accounting expense category.

Input: vendor_name, description, line_items (any combination)

Output: category, confidence, suggested nominal account code, tax_deductible_likely.

Categories: software_subscription, cloud_infrastructure, travel_accommodation, professional_services, marketing_advertising, utilities, hardware_equipment, office_supplies, food_entertainment, insurance, rent_facilities, payroll_contractors, other, unknown

Price: $0.005

MCP endpoint

https://your-deployment.up.railway.app/mcp

Claude Desktop config

{
  "mcpServers": {
    "invoice-intelligence": {
      "url": "https://your-deployment.up.railway.app/mcp",
      "transport": "streamable-http"
    }
  }
}

REST API

# Extract invoice from text
curl -X POST https://your-deployment.up.railway.app/api/extract-invoice \
  -H "Content-Type: application/json" \
  -d '{"text": "INVOICE\nAcme Ltd\nINV-001\n..."}'

# Validate extracted invoice
curl -X POST https://your-deployment.up.railway.app/api/validate-invoice \
  -H "Content-Type: application/json" \
  -d '{"invoice": { ...extract_invoice output... }}'

# Categorise expense
curl -X POST https://your-deployment.up.railway.app/api/categorise-expense \
  -H "Content-Type: application/json" \
  -d '{"vendor_name": "AWS", "description": "Cloud compute"}'

Payment gating (x402)

Set in .env or Railway Variables:

PAYMENTS_ENABLED=true
X402_PAY_TO_ADDRESS=0xYourWalletAddress
X402_NETWORK=eip155:8453
X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402
CDP_API_KEY_ID=your-key
CDP_API_KEY_SECRET=your-secret

Without payment, requests return HTTP 402 with x402 payment instructions.