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(x402v2) com micropagamentos em USDC na rede Base ($0.002a$0.020por 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 rotaGET /sampleeGET /openapi.jsongratuitas 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:
- 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.
- 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.
- 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:
- O cliente ou agente faz a requisição normal (
POST /audit,POST /calc, etc.). - Se não houver cabeçalho de pagamento, o Worker responde
HTTP 402 Payment Requiredcom o cabeçalhoPAYMENT-REQUIRED(Base64 JSON) informando valor exato, ativo (USDC), rede (eip155:8453/ Base) e endereço recebedor. - Um cliente compatível (ex.:
@x402/fetchem 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. - O facilitador (
PayAI) valida e liquida on-chain na Base, e o Worker retorna200 OKcom 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
| API | O que resolve na prática | Endpoint pago | Preço (Base USDC) | Amostra grátis |
|---|---|---|---|---|
| 1. Auditor XML NF-e / NFC-e | Comprime XML SEFAZ 4.00 (~90% menos tokens), confere matemática (vProd/vNF), CFOP, NCM, cStat=100 e decodifica chave de 44 dígitos | POST https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/audit | $0.010 | /sample |
| 2. Leitor de Boletos & Guias BR | Valida e decodifica Boletos FEBRABAN (47/44 dígitos, regra pós-22/02/2025), guias DARF/FGTS/IPTU (48 dígitos) e chaves NF-e | POST https://br-docs-parser-x402.architect-x402.workers.dev/parse | $0.008 | /sample |
| 3. Motor Tributário & Folha BR | Calcula Simples Nacional (Anexos I–V + otimização de Fator R 28%), INSS/IRRF (Legal vs Simplificado) + FGTS e retenções B2B de NFS-e | POST https://br-tax-payroll-calc-x402.architect-x402.workers.dev/calc | $0.008 | /sample |
| 4. Business Intel CNPJ & PIX | Dossiê de CNPJ (QSA, Simples/MEI, score B2B), Geo-CEP IBGE, validador CPF/CNPJ e gerador/leitor de PIX EMVCo CRC16 | POST https://br-business-intel-x402.architect-x402.workers.dev/intel | $0.010 | /sample |
| 5. Calculadoras Banco Central | Correção monetária oficial (IPCA, IGP-M, INPC, Selic, CDI via API SGS do BCB), câmbio PTAX oficial e simulador Price/SAC | POST https://br-fin-calculators-x402.architect-x402.workers.dev/fin | $0.005 | /sample |
| 6. Limpeza Web para IA | Converte páginas HTML pesadas em Markdown limpo, tabelas JSON e JSON-LD com métrica de economia de tokens | GET https://web-enrichment-x402.architect-x402.workers.dev/clean?url=https://example.com&format=json | $0.002 | /sample |
| 7. Firewall Anti-Prompt Injection | Detecta prompt injection (Llama Guard 3 + heurística + decode Base64) e mascara CPF, CNPJ e chaves antes de enviar ao modelo | POST 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!