Invoice Intelligence

Un servidor MCP de pago para procesamiento de facturas. Tres herramientas: extraer datos estructurados de cualquier factura (texto pegado, URL o PDF), validar la factura extraída para verificar su integridad y precisión matemática, y clasificar el gasto en una categoría contable con un código de cuenta nominal sugerido y un indicador de deducibilidad fiscal. Precio desde $0.005 hasta $0.01 por llamada, pagado en USDC en Base a través de x402. No se requiere clave API.

Documentación

Invoice Intelligence MCP

Un servicio MCP de pago que extrae, valida y categoriza facturas. Acepta texto pegado, URLs públicas o PDFs codificados en base64. Impulsado por pagos x402 en la red principal de Base.


Inicio rápido

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

Herramientas

extract_invoice

Extrae datos estructurados de cualquier factura.

Entrada (una requerida):

  • text — texto de factura pegado
  • url — URL pública de la página de factura o PDF
  • pdf_base64 — PDF codificado en base64

Salida: proveedor, cliente, número de factura, fechas, partidas, subtotal, IVA, total, datos bancarios, condiciones de pago, puntuación de confianza.

Precio: $0.01


validate_invoice

Verifica una factura extraída para comprobar su integridad y precisión matemática.

Entrada: invoice — el objeto de salida de extract_invoice

Salida: valid booleano, lista de problemas con severidad, totales recalculados, indicador totals_match.

Precio: $0.005


categorise_expense

Clasifica una factura en una categoría de gasto contable.

Entrada: vendor_name, description, line_items (cualquier combinación)

Salida: categoría, confianza, código de cuenta nominal sugerido, tax_deductible_likely.

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

Precio: $0.005


Endpoint MCP

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

Configuración de Claude Desktop

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

API REST

# 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"}'

Control de pago (x402)

Configurado en .env o Variables de Railway:

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

Sin pago, las solicitudes devuelven HTTP 402 con instrucciones de pago x402.