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.
Server MCP Terhosting
npx add-mcp 'https://br-nfe-xml-auditor-x402.architect-x402.workers.dev/mcp'Terpasang ke Claude Code, Codex, Cursor, dan lainnya
Dokumentasi
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.jsonOpenAPI 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 /sampleem qualquer serviço para inspecionar o payload real sem custo antes de pagar.
Catálogo de APIs em Produção (7 Serviços)
| Serviço | O que resolve na prática | Endpoint Pago (x402) | 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 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ê completo de CNPJ (QSA, Simples/MEI, score de risco 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), câmbio PTAX oficial (BRL/USD/EUR/GBP) e simulador Price/SAC | POST https://br-fin-calculators-x402.architect-x402.workers.dev/fin | $0.005 | /sample |
| 6. Limpeza Web para IA | Converte qualquer página HTML pesada 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 injeção de prompt (Llama Guard 3 + heurística + Base64) e mascara dados sensíveis (CPF, CNPJ, chaves) antes de enviar ao modelo | POST 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_KEYconfigurada (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
402sem quebrar o agente (além da ferramenta gratuitabrazil_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:
- Exemplo TypeScript:
examples/quickstart.ts - Exemplo Python:
examples/quickstart.py
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/x402ePOST /mcp.