emissaoja · NFS-e

br.com.emissaojaPublished by emissaoja.com.brOfficial publisherv0.1.0Updated Oct 29, 2026

Issue Brazilian service invoices (NFS-e) via Emissor Nacional, no digital certificate

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that lets an assistant issue, list and cancel Brazilian service invoices (NFS-e) through the Emissor Nacional for MEI and Simples Nacional…

What you can do
  • Check service health and validate a CNPJ's format and check digits without an account
  • Look up a CNPJ's registration data at the Receita Federal and manage the account company's credential and onboarding
  • List, create and search invoice recipients (tomadores) and list the company's registered services
  • Issue service invoices, track the emission request until authorized, refused or uncertain, and list issued invoices by period or status
  • Cancel an issued invoice and track the cancellation operation
When to use it
Useful for Brazilian MEI or Simples Nacional service providers who want an assistant to prepare and issue NFS-e, manage clients and services, and check or cancel invoices without a digital certificate.
Requirements
Remote streamable HTTP endpoint at emissaoja.com.br. An account is needed for everything except status and validar_cnpj; authenticate with an Authorization bearer API key (ej_live_...) or OAuth sign-in with Google. Connecting the company requires the CNPJ and the Emissor Nacional portal password. Test keys (ej_test_) only work against the sandbox endpoint.
Before you install
Issuing and cancelling invoices have real fiscal effect and cancellation is irreversible; confirm recipient, amount, description and reason with the person first. configurar_credencial asks for the portal password, which the service says it verifies but never stores. The server reads the company's tax registration and invoices from the last 90 days. Never invent tax values; only record figures the person supplied.

Installation

In SourceWeft

  1. Open emissaoja · NFS-e in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/br.com.emissaoja%2Fnfse/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "emissaoja-nfs-e": {
      "type": "http",
      "url": "https://emissaoja.com.br/mcp"
    }
  }
}

Tools

16

status

Status do serviço

Diz se o emissaoja está no ar e como está o motor fiscal. Sem chave.

Takes no parameters.

validar_cnpj

Validar CNPJ

Confere formato e dígitos verificadores de um CNPJ, sem consultar nada. Sem chave.

Parameterscnpjrequired

consultar_cnpj

Consultar CNPJ na Receita

Dados cadastrais de um CNPJ na Receita Federal (razão social, situação, CNAEs, endereço, Simples/MEI, sócios com CPF mascarado). Não cria tomador; para emitir para esse CNPJ use criar_tomador.

Parameterscnpjrequired

minha_empresa

Minha empresa

A empresa da conta: CNPJ, nome, estado da credencial do Emissor Nacional (ausente, verificando, ativa, congelada), estado do onboarding (configurando, perguntas, pronto…), importação e avisos. Comece por aqui: se a credencial está ausente, a pessoa precisa conectar a empresa (configurar_credencial); se há perguntas, responda-as com responder_perguntas_fiscais.

Takes no parameters.

configurar_credencial

Conectar a empresa (CNPJ e senha do Emissor Nacional)

Conecta a empresa da conta ao Emissor Nacional com o CNPJ e a senha do portal (não é a conta gov.br). A senha é conferida no portal, nunca guardada nem devolvida. Depois o emissaoja lê o cadastro fiscal e traz as notas dos últimos 90 dias. Só use quando a pessoa pedir e informar a senha ela mesma; são no máximo 3 tentativas erradas por dia (regra do portal, para não bloquear a conta da empresa). Responde na hora com a tentativa; acompanhe com situacao_credencial até proximo_passo sair de "aguardar".

Parameterscnpjrequiredsenharequiredciente_ultima_tentativa

situacao_credencial

Situação da credencial

Estado da credencial e da última tentativa de conexão: estado (verificando, aceita, senha_recusada, portal_indisponivel, bloqueada…) e proximo_passo (aguardar, configurando, pronto, corrigir_senha, tentar_mais_tarde, redefinir_no_portal, suporte). Consulte a cada poucos segundos enquanto for "aguardar".

Takes no parameters.

perguntas_fiscais

Perguntas fiscais pendentes

Estágios do onboarding, perguntas que o cadastro fiscal não responde sozinho (alíquota do Simples, regime de apuração) e bloqueios. Responda com responder_perguntas_fiscais.

Takes no parameters.

responder_perguntas_fiscais

Responder as perguntas fiscais

Grava a alíquota do Simples Nacional (percentual da última apuração, 0 < x ≤ 33) e/ou o regime de apuração (1 = competência, 2 = caixa, 3 = outro). Só com valores que a pessoa informou; nunca invente.

Parametersreg_ap_trib_snaliquota_simples

listar_tomadores

Listar tomadores (clientes)

Lista os tomadores (clientes) da empresa, com busca por nome ou documento. Cada um tem tipo (pj/pf), id, nome e documento; o par tipo + id é o que emitir_nota usa.

Parametersbuscapagina

criar_tomador

Criar tomador (cliente)

Cadastra um cliente pelo CNPJ (nome e endereço vêm da Receita) ou pelo CPF com o nome completo. Se já existir, devolve o existente (ja_existia). Devolve tipo + id para emitir_nota.

Parametersnomedocumentorequired

listar_servicos

Listar serviços

Serviços cadastrados da empresa (descrição, código nacional de tributação, ISS, principal). emitir_nota usa o principal quando servico_id não é informado.

Parametersativos

emitir_nota

Emitir NFS-e

Emite uma nota fiscal de serviço no Emissor Nacional para um tomador já cadastrado (use listar_tomadores ou criar_tomador antes). Faz a prévia e, sem bloqueio, pede a emissão: responde com o pedido (acompanhe com acompanhar_pedido até autorizada, recusada ou incerta). Com bloqueio, devolve o que falta (bloqueios com code, mensagem e acao) em vez de emitir. Passe sempre uma referencia única por nota que a pessoa quer emitir (ex.: "pedido-123"): repetir a mesma referencia devolve o mesmo pedido e nunca emite duas vezes. Confirme com a pessoa tomador, valor e descrição antes de chamar; a nota tem efeito fiscal real.

Parametersvalorrequireddescricaoreferenciaservico_idtomador_idrequiredcompetenciatomador_tiporequiredconfirmo_repeticaopermitir_repetida_de

acompanhar_pedido

Acompanhar pedido de emissão

Estado de um pedido de emissão: na_fila, emitindo, confirmando, autorizada (com numero e chave_acesso), recusada (com motivo) ou incerta. Consulte de novo depois de proxima_consulta_ms enquanto não for terminal.

Parameterspedido_idrequired

listar_notas

Listar notas emitidas

Notas emitidas (locais e importadas do portal) com número, situação, data, tomador, valor e o par origem + id que cancelar_nota usa. Filtros por período (mes_atual, mes_anterior, ano_atual, 12_meses), situação (todas, emitidas, canceladas) e busca.

Parametersbuscalimiteperiodosituacao

cancelar_nota

Cancelar NFS-e

Cancela uma nota emitida, dentro do prazo do Emissor Nacional. Irreversível: confirme com a pessoa a nota (número, tomador, valor) e o motivo antes. Responde com a operação; acompanhe com acompanhar_operacao (processando → concluida ou falhou).

Parametersmotivorequiredorigemrequirednota_idrequiredjustificativa

acompanhar_operacao

Acompanhar operação

Estado de uma operação (cancelamento): processando, concluida ou falhou (com o erro).

Parametersoperacao_idrequired

Version history

1
  1. v0.1.0LatestOct 29, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.