Factur-X by Orvel

Servidor MCP Factur-X

Gere, valide e leia faturas eletrônicas Factur-X / EN 16931 (França, UE) a partir de qualquer cliente MCP.
Servidor remoto, sem instalação. PDF/A-3 · CII · UBL 2.1 · Regras francesas fr-ctc.

Documentação · Guia MCP · Preços (chave gratuita, sem cartão) · Relatório de conformidade · Status

---

Endpoint: https://facturx.orvel.dev/mcp (HTTP Streamable, sem estado) Registro: io.github.LeBorgneAntoine/facturx no registro oficial de MCP

A França torna a faturação eletrônica obrigatória para todas as empresas registradas para IVA (recebimento a partir de setembro de 2026, emissão em 2026–2027). Factur-X é o formato híbrido PDF + XML dessa reforma. Este servidor permite que um agente de IA no Claude, Cursor, VS Code, ChatGPT ou no seu próprio aplicativo produza, verifique e leia faturas em conformidade sem escrever uma integração.

Ferramentas

Ferramenta	O que faz
generate_invoice	JSON de fatura → PDF/A-3 Factur-X, XML CII ou XML UBL. Perfis MINIMUM → EXTENDED, EN 16931, renderização FR/EN
embed_xml	Anexe um XML Factur-X ao seu próprio PDF e produza um PDF/A-3 válido
validate_invoice	XSD + schematron EN 16931 (+ regras francesas fr-ctc), resultados estruturados com IDs de regras
extract_invoice	Leia uma fatura eletrônica em PDF ou XML: partes, totais, detalhamento de IVA, linhas

Recursos: facturx://schema/invoice (JSON Schema do objeto de fatura) e facturx://guide/french-reform.

Todas as ferramentas são readOnlyHint / idempotentHint. Nada é armazenado no servidor. initialize, tools/list e resources/* funcionam sem chave para que você possa inspecionar o servidor antes de escolher um plano.

Conectar

Obtenha uma chave em facturx.orvel.dev/docs/pricing (Plano gratuito: 50 documentos/mês, sem cartão) e envie-a como Authorization: Bearer <key>.

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "facturx": {
      "url": "https://facturx.orvel.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "facturx": {
      "type": "http",
      "url": "https://facturx.orvel.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Code

claude mcp add --transport http facturx https://facturx.orvel.dev/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Desktop (conectores personalizados ainda não podem enviar cabeçalhos, então use uma ponte com mcp-remote)

{
  "mcpServers": {
    "facturx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://facturx.orvel.dev/mcp", "--header", "Authorization: Bearer ${FACTURX_KEY}"],
      "env": { "FACTURX_KEY": "YOUR_KEY" }
    }
  }
}

Mais clientes (SDK Python, AgenticMarket pay-per-call) no Guia MCP.

Exemplos de prompts

• "Gere uma fatura Factur-X para este orçamento: vendedor Atelier Numérique SAS (SIREN 732829320, IVA FR40732829320, Paris), comprador Boulangerie Dupont (SIREN 552081317, Lyon), 1 × desenvolvimento de site 2500 EUR HT a 20 %, 12 meses de hospedagem a 15 EUR, vencimento em 30 dias."
• "Valide a fatura de fornecedor anexada de acordo com as regras francesas e explique cada regra reprovada em palavras simples."
• "Extraia os totais e o detalhamento de IVA destes três PDFs e me dê uma tabela."

Conformidade

Cada amostra publicada é validada por um motor independente (Mustangproject, o validador de referência de código aberto para Factur-X): XSD, schematron EN 16931, regras francesas CTC, PDF/A-3 com o factur-x.xml incorporado. Relatórios e etapas de reprodução: Conformidade.

API REST

O mesmo motor está disponível como API REST (/v1/invoices/generate, /v1/validate, /v1/extract, OpenAPI em /openapi.json). Uma chave, ambas as interfaces, uma cota. Consulte a Referência da API.

Sobre

Construído e operado por Orvel (Antoine Le Borgne, França). Hospedado na UE (Railway, Amsterdã). Suporte: support@orvel.dev.

Este repositório contém o manifesto público (server.json), ativos de marca e exemplos de clientes do servidor hospedado. O motor em si é de código fechado.