Brazil AI & x402 Fiscal & Financial MCP Suite

7 Brazilian fiscal, financial, CNPJ/PIX, BCB indicators (IPCA/CDI/PTAX), NF-e XML audit, Simples Nacional payroll, web extraction, and prompt-injection guard APIs via x402 Base USDC micropayments.

Hosted MCP Server

npx add-mcp 'https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Suíte Brasil IA — APIs Fiscais, Contábeis, Financeiras e Segurança

English Documentation (README.en.md) | Guia B2B para Empresas (PIX / API Key) | Catálogo JSON | llms.txt

Conjunto de 7 APIs serverless em produção na Cloudflare Edge projetadas para escritórios de contabilidade, BPOs financeiros, ERPs, fintechs, automações (n8n / Make) e agentes autônomos de IA.

  • Indexadas oficialmente: Compatíveis com x402scan.com (GET /openapi.json OpenAPI 3.1.0) e PayAI Bazaar (eip155:8453 / Base Mainnet USDC).
  • Conector MCP Unificado em 1 comando: Conecte todas as 7 ferramentas de uma vez no Claude Desktop, Cursor, VS Code ou Windsurf via npx -y github:brunopompeo1/brazil-ai-fiscal-apis-x402.
  • Amostra gratuita em cada API: Chame GET /sample em qualquer serviço para inspecionar o payload real sem custo antes de pagar.

Catálogo de APIs em Produção (7 Serviços)

ServiçoO que resolve na práticaEndpoint Pago (x402)Preç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 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ê completo de CNPJ (QSA, Simples/MEI, score de risco 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), câmbio PTAX oficial (BRL/USD/EUR/GBP) e simulador Price/SACPOST https://br-fin-calculators-x402.architect-x402.workers.dev/fin$0.005/sample
6. Limpeza Web para IAConverte qualquer página HTML pesada 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 injeção de prompt (Llama Guard 3 + heurística + Base64) e mascara dados sensíveis (CPF, CNPJ, chaves) antes de enviar ao modeloPOST https://agent-guard-x402.architect-x402.workers.dev/guard$0.008/sample

Como usar agora mesmo

1. Servidor MCP Unificado (Claude Desktop, Cursor, VS Code, Windsurf)

Cole no seu claude_desktop_config.json ou .cursor/mcp.json (ver examples/ai-connectors.json):

{
  "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"
      }
    }
  }
}
  • Com X402_PRIVATE_KEY configurada (carteira com USDC na Base), os micropagamentos x402 ocorrem automaticamente via @x402/fetch.
  • Sem carteira configurada, todas as ferramentas continuam visíveis e retornam os requisitos exatos HTTP 402 sem quebrar o agente (além da ferramenta gratuita brazil_ai_suite_status).

2. Em Sistemas, ERPs, Python ou TypeScript (Pay-per-use x402)

Todas as rotas pagas retornam HTTP 402 com o cabeçalho PAYMENT-REQUIRED detalhando o valor em USDC na rede Base:

Teste rápido via terminal (curl) para ver o contrato OpenAPI 3.1 ou a amostra gratuita:

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

3. Contratação B2B para Empresas e Escritórios (PIX / Mensalidade)

Quer integrar no seu ERP, sistema contábil ou fluxo n8n pagando mensalidade fixa em Reais via PIX com API Key dedicada (sem precisar usar carteira cripto)?

Confira os planos e peça um piloto em docs/GUIA_EMPRESAS_B2B.md.


Descoberta Automática para IAs

  • Catálogo completo: catalog.json
  • Índice llms.txt: llms.txt
  • Cada serviço expõe individualmente GET /openapi.json, GET /sample, GET /llms.txt, GET /.well-known/x402 e POST /mcp.