Invoice Intelligence

Um servidor MCP pago para processamento de faturas. Três ferramentas: extrair dados estruturados de qualquer fatura (texto colado, URL ou PDF), validar a fatura extraída quanto à completude e precisão matemática, e classificar a despesa em uma categoria contábil com um código de conta nominal sugerido e indicador de dedutibilidade fiscal. Preço de $0,005 a $0,01 por chamada, pago em USDC na Base via x402. Nenhuma chave de API necessária.

Documentação

Invoice Intelligence MCP

Um serviço MCP pago que extrai, valida e categoriza faturas. Aceita texto colado, URLs públicas ou PDFs codificados em base64. Alimentado por pagamentos x402 na Base mainnet.


Início 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

Ferramentas

extract_invoice

Extrai dados estruturados de qualquer fatura.

Entrada (uma obrigatória):

  • text — texto da fatura colado
  • url — URL pública da página da fatura ou PDF
  • pdf_base64 — PDF codificado em base64

Saída: fornecedor, cliente, número da fatura, datas, itens de linha, subtotal, IVA, total, dados bancários, condições de pagamento, pontuação de confiança.

Preço: $0.01


validate_invoice

Verifica se uma fatura extraída está completa e matematicamente correta.

Entrada: invoice — o objeto de saída de extract_invoice

Saída: valid booleano, lista de problemas com gravidade, totais recalculados, sinalizador totals_match.

Preço: $0.005


categorise_expense

Classifica uma fatura em uma categoria de despesa contábil.

Entrada: vendor_name, description, line_items (qualquer combinação)

Saída: categoria, confiança, código de conta nominal sugerido, tax_deductible_likely.

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

Preço: $0.005


Endpoint MCP

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

Configuração do 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"}'

Gating de pagamento (x402)

Definido em .env ou 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

Sem pagamento, as solicitações retornam HTTP 402 com instruções de pagamento x402.