emissaoja MCP server: issue Brazilian NFS-e from your AI assistant

Remote Model Context Protocol server to issue Brazilian service invoices (NFS-e, Nota Fiscal de Serviço eletrônica) through the national Emissor Nacional (nfse.gov.br), without a digital certificate. Built for MEI and Simples Nacional companies. Works in Claude, ChatGPT, Claude Code, Cursor, VS Code, Cline and any MCP client that supports Streamable HTTP.

https://emissaoja.com.br/mcp

This repository holds the public documentation and the MCP Registry manifest (server.json, name br.com.emissaoja/nfse). The server is hosted by emissaoja; there is nothing to install or run.

Tools

emitir_nota and cancelar_nota have real tax effect: their descriptions tell the assistant to confirm customer, amount and description (or the invoice and reason) with you before calling.

Related MCP server: brazil-invoice-mcp

Authentication

• OAuth (recommended): Claude, ChatGPT, Claude Code, Cursor and VS Code open the emissaoja sign-in the first time a tool needs an account. Sign in with Google and authorize. The connection lasts 60 days without use and can be revoked in Conta → API.

• API key: clients without OAuth send Authorization: Bearer ej_live_.... Create the key in emissaoja.com.br → Conta → API.

• Sandbox: https://sandbox.emissaoja.com.br/mcp with ej_test_ keys runs against a simulated Emissor Nacional (nothing reaches the tax authority). Example company: CNPJ 11111111000191, any password.

Connect

Claude (claude.ai, Desktop, mobile): Settings → Connectors → Add custom connector → URL https://emissaoja.com.br/mcp.

ChatGPT: Settings → Apps & Connectors → enable Developer mode → Add custom MCP server → URL https://emissaoja.com.br/mcp, authentication OAuth.

Claude Code:

claude mcp add --transport http emissaoja https://emissaoja.com.br/mcp
# or with an API key:
claude mcp add --transport http emissaoja https://emissaoja.com.br/mcp --header "Authorization: Bearer ej_live_YOUR_KEY"

Cursor: use the install button above, the emissaoja Cursor plugin, or add to .cursor/mcp.json:

{ "mcpServers": { "emissaoja": { "url": "https://emissaoja.com.br/mcp" } } }

VS Code: use the install button above, or add to .vscode/mcp.json:

{ "servers": { "emissaoja": { "type": "http", "url": "https://emissaoja.com.br/mcp" } } }

Cline: see llms-install.md.

Other clients (API key):

{
  "mcpServers": {
    "emissaoja": {
      "type": "http",
      "url": "https://emissaoja.com.br/mcp",
      "headers": { "Authorization": "Bearer ej_live_YOUR_KEY" }
    }
  }
}

Example prompts

• "Emite uma nota de R$ 1.500 para a Alfa Ltda, CNPJ 12.345.678/0001-95, referente à consultoria de novembro."

• "Quais notas eu emiti este mês e qual o total?"

• "A nota 42 saiu com o valor errado: cancela por erro na emissão e emite outra de R$ 1.200."

• "Minha empresa já está pronta para emitir? O que falta configurar?"

• "Consulta o CNPJ 12.345.678/0001-95 antes de cadastrar como cliente."

Em português

Servidor MCP remoto do emissaoja para emitir NFS-e pelo seu assistente de IA (Claude, ChatGPT, Cursor, VS Code): o assistente consulta sua empresa, cadastra clientes pelo CNPJ, emite a nota no Emissor Nacional sem certificado digital, acompanha a autorização e cancela, sempre confirmando com você antes de emitir ou cancelar. Para MEI e empresas do Simples Nacional. Plano Grátis com 1 nota por mês; planos em emissaoja.com.br/#precos. Documentação da API: emissaoja.com.br/docs.

Bibliotecas oficiais da mesma API: Node.js/TypeScript · Python · PHP/Laravel · .NET · Go · Ruby · n8n · WooCommerce.

Limits and scope

• Companies: MEI, ME and EPP under Simples Nacional, in a municipality that issues through Emissor Nacional. One company per account.

• Rate limits: 60 calls/min per key, 10 issuances/min. An invoice counts toward the plan when Emissor Nacional accepts it; refused invoices do not count.

• Support: suporte@emissaoja.com.br · Terms: https://emissaoja.com.br/termos/ · Privacy: https://emissaoja.com.br/privacidade/

emissaoja is a private service, operated by BINOBO LTDA, with no affiliation with Receita Federal or Emissor Nacional.