🇧🇷 Brazil Invoice MCP live

AI agents can now issue Brazil NFS-e electronic service invoices (nota fiscal de serviço eletrônica). This remote MCP server wraps Focus NFe — invoices are authorized by your municipality (prefeitura) — with three tools: create_invoice, query_invoice, cancel_invoice.

Connect

{
  "mcpServers": {
    "brazil-invoice": {
      "type": "http",
      "url": "https://inv-br.wishpool.app/mcp",
      "headers": { "x-focusnfe-token": "your_homologacao_token" }
    }
  }
}

Free homologação (sandbox) tokens from focusnfe.com.br issue test NFS-e with no fiscal effect. Add "x-focusnfe-mode": "production" with your produção token to issue real ones. Your digital certificate and inscrição municipal stay in your own Focus NFe account.

Asynchronous by design

NFS-e authorization at the prefeitura is asynchronous: create_invoice returns PROCESSING plus a ref. Poll query_invoice with that ref until AUTHORIZED (nota autorizada, with numero + codigo_verificacao) or ERROR.

Why it is safe

• Stateless: no database — credentials travel per-request in headers and are never stored.
• Authorization stays upstream: Focus NFe carries the prefeitura/SEFAZ integration; we only translate MCP calls.
• Owner policy guardrails: x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools — set by the human owner in client config; the agent cannot relax them.

Weak-model friendly

Sensible defaults baked in (natureza_operacao 1, optante_simples_nacional true, sandbox unless you opt into production); every create result embeds numbered next_steps; every error teaches the fix (CNPJ/CPF format, item_lista_servico, justificativa 15-255 chars).

Sister servers

Mexico CFDI invoices are live at inv-mx.wishpool.app. Local payments in 81 countries — one family, same stateless pattern: mcp.wishpool.app (Taiwan e-invoice 電子發票 included). More invoice countries coming: Chile DTE, Peru CPE, India GST, Poland KSeF, Romania e-Factura, Italy SdI. Brazil NF-e (goods) is on the v2 roadmap.