
agent-email-x402
io.github.brunopompeo1/agent-email-x402
Transactional email dispatcher (Markdown to responsive HTML) for AI agents via x402 Base USDC.
Documentation
Suíte Brasil IA — APIs Fiscais, Contábeis, Financeiras, E-mail & Segurança (x402 + MCP)
English Documentation (README.en.md) | Guia B2B para Empresas (PIX / API Key) | Catálogo JSON | llms.txt
Conjunto de 9 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.
- Liquidação nativa x402 v2 na rede Base: Compatíveis com Coinbase CDP Facilitator (e fallback automático PayAI), listadas no Agentic Market, x402scan.com (
GET /openapi.jsonOpenAPI 3.1.0), Glama Connectors e Official MCP Registry. - Conector MCP Unificado em 1 comando: Conecte todas as 9 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 (9 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. DANFSe Nacional & Reforma Tributária (RTC) | Gera DANFSe oficial da NFS-e Nacional e calcula tributos da Reforma Tributária (CBS, IBS e ISS — LC 214/2025) | POST https://br-danfse-rtc-x402.architect-x402.workers.dev/generate | $0.005 | /sample |
| 3. 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 |
| 4. 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 |
| 5. 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 |
| 6. 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 |
| 7. 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 |
| 8. Disparo de E-mail para Agentes | Gateway transacional pay-per-call sem mensalidade SaaS: compila Markdown em HTML responsivo e envia alertas/notificações por e-mail | POST https://agent-email-x402.architect-x402.workers.dev/send | $0.005 | /sample |
| 9. 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
Descobrir não executa uma ferramenta paga. Sem credenciais, o conector inicia em discovery_only: lista ferramentas, mas chamadas reais retornam cobrança. Configure localmente X402_PRIVATE_KEY com uma carteira com USDC na Base, ou BRAZIL_AI_API_KEY com uma chave B2B válida. Não compartilhe credenciais em mensagens.
Após instalar as dependências do repositório, teste a amostra gratuita com node examples/execute.mjs. Para executar uma chamada real de limpeza web, use node examples/execute.mjs --execute: custa 0,002 USDC com carteira, ou consome uma chamada da cota B2B. O exemplo usa o mesmo cliente de pagamento do conector e devolve erro se a execução falhar.
Os endereços remotos /mcp também exigem um cliente que trate a cobrança x402 ou envie X-API-Key; adicionar apenas a URL não configura pagamento automático. Os exemplos quickstart.ts e quickstart.py inspecionam a cobrança, sem liquidar pagamentos.
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": "",
"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-danfse-rtc-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 /health,GET /openapi.json,GET /sample,GET /llms.txt,GET /.well-known/x402ePOST /mcp.
No installation packages available.
Remote
Related Servers
io.github.brunopompeo1/agent-guard-x402
Hybrid Edge AI firewall (Llama Guard 3 + heuristics) for prompt injection & PII via x402 USDC.
io.github.brunopompeo1/br-business-intel-x402
Brazil CNPJ KYB dossier, IBGE CEP lookup, CPF/CNPJ validator & PIX EMVCo CRC16 via x402 Base USDC.
io.github.brunopompeo1/br-danfse-rtc-x402
Brazil DANFSe Nacional HTML & Tax Reform CBS/IBS/ISS (LC 214/2025) engine via x402 Base USDC.