1

Pitch: Construí 7 APIs fiscais e financeiras BR na Cloudflare Edge cobrando por requisição em USDC (HTTP 402 + MCP)

Resumo: Coloquei no ar uma suíte de 7 microsserviços serverless em Cloudflare Workers voltados para automações (n8n, Make, ERPs) e agentes de IA (Claude, Cursor, scripts autônomos), usando o padrão HTTP 402 Payment Required (x402 v2) com micropagamentos em USDC na rede Base ($0.002 a $0.020 por chamada) e um servidor MCP unificado com 8 ferramentas.

Repositório / vitrine (MIT): https://github.com/brunopompeo1/brazil-ai-fiscal-apis-x402
Nota importante: Todas as APIs têm rota GET /sample e GET /openapi.json gratuitas para inspecionar o payload real sem gastar nada.


Por que não resolver tudo direto no prompt do LLM?

Quem já tentou jogar um XML de NF-e 4.00 inteiro, uma linha digitável de boleto pós-fev/2025 ou um cálculo de Simples Nacional com Fator R direto no contexto de um LLM sabe dos três problemas clássicos:

  1. Desperdício de tokens: Um XML padrão da SEFAZ consome facilmente ~4.000+ tokens com tags repetitivas e assinaturas digitais, sendo que o agente só precisa de 15 campos validados.
  2. Alucinação matemática e tributária: Modelos erram cálculo de módulo 11 em chave de 44 dígitos, erram o reset do fator de vencimento FEBRABAN (22/02/2025) e erram faixas progressivas de INSS/IRRF.
  3. Atrito de cadastro para agentes autônomos: Um agente rodando em pipeline não consegue abrir tela de checkout, colocar cartão de crédito ou assinar plano mensal.

A ideia aqui foi separar determinismo na Edge (Cloudflare Workers, latência baixa, zero dependência pesada) + pagamento por uso nativo no próprio HTTP (x402).


Como funciona o fluxo HTTP 402 (x402 v2) na prática

Sem chave de API obrigatória, sem plano mensal e sem cadastro prévio para quem paga por chamada:

  1. O cliente ou agente faz a requisição normal (POST /audit, POST /calc, etc.).
  2. Se não houver cabeçalho de pagamento, o Worker responde HTTP 402 Payment Required com o cabeçalho PAYMENT-REQUIRED (Base64 JSON) informando valor exato, ativo (USDC), rede (eip155:8453 / Base) e endereço recebedor.
  3. Um cliente compatível (ex.: @x402/fetch em TS/JS ou conector MCP com carteira Base configurada) assina a autorização de transferência (EIP-3009) e reenvia a requisição com o pagamento.
  4. O facilitador (PayAI) valida e liquida on-chain na Base, e o Worker retorna 200 OK com o JSON estruturado.

Para inspecionar o contrato 402 sem gastar nada, basta rodar um POST vazio ou usar o GET /sample:

curl -s https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/sample
curl -s https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/openapi.json

As 7 APIs em produção

APIO que resolve na práticaEndpoint pagoPreço (Base USDC)Amostra grátis
1. Auditor XML NF-e / NFC-eComprime XML SEFAZ 4.00 (~90% menos tokens), confere matemática (vProd/vNF), CFOP, NCM, cStat=100 e decodifica chave de 44 dígitosPOST https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/audit$0.010/sample
2. Leitor de Boletos & Guias BRValida e decodifica Boletos FEBRABAN (47/44 dígitos, regra pós-22/02/2025), guias DARF/FGTS/IPTU (48 dígitos) e chaves NF-ePOST https://br-docs-parser-x402.architect-x402.workers.dev/parse$0.008/sample
3. Motor Tributário & Folha BRCalcula Simples Nacional (Anexos I–V + otimização de Fator R 28%), INSS/IRRF (Legal vs Simplificado) + FGTS e retenções B2B de NFS-ePOST https://br-tax-payroll-calc-x402.architect-x402.workers.dev/calc$0.008/sample
4. Business Intel CNPJ & PIXDossiê de CNPJ (QSA, Simples/MEI, score B2B), Geo-CEP IBGE, validador CPF/CNPJ e gerador/leitor de PIX EMVCo CRC16POST https://br-business-intel-x402.architect-x402.workers.dev/intel$0.010/sample
5. Calculadoras Banco CentralCorreção monetária oficial (IPCA, IGP-M, INPC, Selic, CDI via API SGS do BCB), câmbio PTAX oficial e simulador Price/SACPOST https://br-fin-calculators-x402.architect-x402.workers.dev/fin$0.005/sample
6. Limpeza Web para IAConverte páginas HTML pesadas em Markdown limpo, tabelas JSON e JSON-LD com métrica de economia de tokensGET https://web-enrichment-x402.architect-x402.workers.dev/clean?url=https://example.com&format=json$0.002/sample
7. Firewall Anti-Prompt InjectionDetecta prompt injection (Llama Guard 3 + heurística + decode Base64) e mascara CPF, CNPJ e chaves antes de enviar ao modeloPOST https://agent-guard-x402.architect-x402.workers.dev/guard$0.020/sample

Conectando direto no Claude Desktop, Cursor ou VS Code (MCP)

Para não precisar configurar endpoint por endpoint, empacotei as 7 APIs + uma ferramenta gratuita de descoberta (brazil_ai_suite_status) em um servidor MCP único (também publicado no Glama.ai e no Official MCP Registry):

{
  "mcpServers": {
    "brazil-ai-suite": {
      "command": "npx",
      "args": ["-y", "github:brunopompeo1/brazil-ai-fiscal-apis-x402"],
      "env": {
        "X402_PRIVATE_KEY": "0xSUA_CHAVE_PRIVADA_BASE_OPCIONAL",
        "X402_MAX_USDC_PER_CALL": "0.05"
      }
    }
  }
}

Mesmo sem X402_PRIVATE_KEY, o servidor sobe normalmente, lista todas as ferramentas e retorna os detalhes do 402 de forma segura (sem quebrar o loop do agente). Cada Worker também expõe POST /mcp (streamable-http), GET /llms.txt e GET /.well-known/x402.


E para empresas / escritórios que não querem usar cripto?

Para cenários tradicionais (escritórios de contabilidade, BPOs e softwares house usando n8n ou ERP), também deixei documentado o modelo de acesso B2B por API Key mensal via PIX (Guia B2B), rodando sobre a mesma infraestrutura Edge.


O que eu gostaria de ouvir de vocês

  • Alguém aqui no Brasil já está usando HTTP 402 (x402) ou MCP remoto em produção para monetizar micro-APIs?
  • Para quem trabalha com automação fiscal/contábil (n8n, ERPs, BPO), quais outras validações determinísticas fariam mais sentido entrarem na próxima leva (ex.: NFS-e Padrão Nacional, validador de SPED, CNAB 240/400)?

Fico por aqui acompanhando os comentários e feedbacks técnicos!

Carregando publicação patrocinada...