emissaoja · NFS-e MCP Server

by com-emissaoja Your server? Claim it

answering

emissaoja · NFS-e is answering right now. Last checked 7 min ago. It exposes 16 tools.

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

Uptime history 6 days of history

6 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

920 ms

Response time

average over 24h

open, no key

Access

streamable-http

Nothing serious here today

Today is the operative word: we check emissaoja · NFS-e every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 7 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add nfse --transport http https://emissaoja.com.br/mcp

Settings → Connectors → Add custom connector, then paste this address

https://emissaoja.com.br/mcp

~/.codex/config.toml

[mcp_servers.nfse]
url = "https://emissaoja.com.br/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 16

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

listar

listar_notas

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.

listar_servicos

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.

listar_tomadores

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.

acompanhar

acompanhar_operacao

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

acompanhar_pedido

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.

cancelar

cancelar_nota

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).

configurar

configurar_credencial

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".

consultar

consultar_cnpj

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.

criar

criar_tomador

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.

emitir

emitir_nota

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.

minha

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.

perguntas

perguntas_fiscais

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.

responder

responder_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.

situacao

situacao_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".

status

status

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

validar

validar_cnpj

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

Endpoints

URL	Transport	State	Latency	Checked
https://emissaoja.com.br/mcp	streamable-http	answering	893 ms	7 min ago

Alternatives to emissaoja · NFS-e

same job, measured the same way

NotaMCP

by csseocao

Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.

10 tools answering

Nota Fiscal

by mcp-dir

Issue and manage Brazilian service invoices (NFS-e) by chatting with your agent, platform-hosted, no

12 tools answering

DF-e

by mcp-dir

Brazilian SEFAZ e-invoices (NF-e, CT-e) issued against your company. A1 cert, DANFE PDF.

12 tools answering

Detritus Site Services: Your Account

by detritus

Manage your Detritus account: sites, services, quotes, invoices, and notifications.

answering

Invoicetronic MCP Server

by fgasparetto

MCP server for Italian electronic invoicing (SDI) via Invoicetronic API

87 installs/wk local only

Einvoicewiz

by einvoicewiz

Generate & validate EN 16931 e-invoices (Factur-X, ZUGFeRD, XRechnung); verification certificates

7 tools answering

PaperType

by papertype

Render Markdown, HTML or invoice/certificate/report templates to PDF files via the PaperType API.

107 installs/wk local only

Cefidia

by cefidia

Issue, sign and manage Mexican CFDI 4.0 e-invoices, complements and credit notes.

answering

emissaoja · NFS-e — questions

Answers built from our own checks of this server.

What can emissaoja · NFS-e do?

It exposes 16 tools, read directly from the server on our last check. Among them: acompanhar_operacao, acompanhar_pedido, cancelar_nota, configurar_credencial, consultar_cnpj, criar_tomador and 10 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is emissaoja · NFS-e mostly used for?

Its tools cluster around listar and acompanhar. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is emissaoja · NFS-e working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 920 ms. The bar chart above shows every period we have measured.

How do I connect emissaoja · NFS-e?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does emissaoja · NFS-e need an API key?

No. emissaoja · NFS-e completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 16 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is emissaoja · NFS-e?

It answers our handshake in 920 ms on average, which is faster than 8% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.