# Brazil Invoice MCP

> A remote MCP server that lets any AI agent issue Brazil NFS-e (nota fiscal de serviço eletrônica — the municipal electronic service invoice, authorized by the prefeitura) via Focus NFe — create, query and cancel service invoices. Stateless, bring-your-own credentials, never stores anything.

- MCP endpoint (Streamable HTTP): https://inv-br.wishpool.app/mcp
- Credentials header: x-focusnfe-token: your Focus NFe API token (free homologação/sandbox token issues test NFS-e with no fiscal effect; the produção token issues real ones). Your digital certificate and inscrição municipal stay in your own Focus NFe account.
- Mode header: x-focusnfe-mode: production to hit the real prefeitura endpoint; omitted = safer homologação sandbox (default).
- Flow (asynchronous): create_invoice submits the NFS-e and returns status PROCESSING + a ref -> poll query_invoice with that ref until AUTHORIZED (nota autorizada, with numero + codigo_verificacao) or ERROR -> cancel_invoice voids an authorized one with a justificativa (15-255 chars).
- Amounts in BRL (reais). Service classified by item_lista_servico (Lei Complementar 116 code, e.g. 01.07). ISS is the municipal service tax; iss_retido defaults false, natureza_operacao defaults "1", optante_simples_nacional defaults true.

## Tools

- create_invoice: Issue an NFS-e (nota fiscal de serviço) — provider CNPJ + inscrição municipal, buyer name + CPF/CNPJ, valor_servicos + discriminação + item_lista_servico in, a ref out (poll query_invoice; issuance is async).
- query_invoice: Check NFS-e status by ref — PROCESSING, AUTHORIZED (numero + codigo_verificacao + url), ERROR (with message), or CANCELED.
- cancel_invoice: Void an authorized NFS-e at the prefeitura with a justificativa (15-255 characters).
- Owner policy guardrails: x-agentpay-max-amount (hard cap on valor_servicos), x-agentpay-approval-above (returns an unsigned draft for human review), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them.

## Safety

Stateless translation layer. The prefeitura/SEFAZ authorization burden sits with Focus NFe; the merchant's digital certificate, inscrição municipal and API token stay in the merchant's own Focus NFe account. This server never stores credentials, invoices, or customer data. Privacy policy: https://inv-br.wishpool.app/privacy

## Sister servers

Same stateless BYO pattern. Mexico CFDI invoices are live: https://inv-mx.wishpool.app. Local payments in 81 countries — full list: https://mcp.wishpool.app/llms.txt (Taiwan e-invoice 電子發票 lives in https://mcp.wishpool.app/mcp). More invoice countries coming: Chile DTE, Peru CPE, India GST e-invoicing, Poland KSeF, Romania e-Factura, Italy SdI. Brazil NF-e (goods invoice) is on the v2 roadmap for this server.