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.