Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

claude mcp add --transport http nfse https://emissaoja.com.br/mcp --header "Authorization: Bearer ${NFSE_TOKEN}"

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nfse": {
      "type": "remote",
      "url": "https://emissaoja.com.br/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:NFSE_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "nfse": {
      "type": "http",
      "url": "https://emissaoja.com.br/mcp",
      "headers": {
        "Authorization": "Bearer ${NFSE_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=nfse&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZW1pc3Nhb2phLmNvbS5ici9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtORlNFX1RPS0VOfSJ9fQ%3D%3D"
}

{
  "servers": {
    "nfse": {
      "type": "http",
      "url": "https://emissaoja.com.br/mcp",
      "headers": {
        "Authorization": "Bearer ${NFSE_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "nfse": {
      "httpUrl": "https://emissaoja.com.br/mcp",
      "headers": {
        "Authorization": "Bearer ${NFSE_TOKEN}"
      }
    }
  }
}

extensions:
  "nfse":
    enabled: true
    name: "nfse"
    type: streamable_http
    uri: "https://emissaoja.com.br/mcp"
    headers:
      "Authorization": "Bearer ${NFSE_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${NFSE_TOKEN}. The registry never accepts secret values.

Quality 88 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations16 of 16 tools declare readOnlyHint or destructiveHint
warn
tools.directory_hints5 of 16 tools declare all four hints; missing: listar_servicos (idempotentHint); validar_cnpj (idempotentHint); minha_empresa (idempotentHint); …
pass
tools.token_costabout 2,487 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

16 tools, about 2,487 tokens to load them all · tool set 71a6dd3c3f82 · checked 2026-11-07 19:44 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 83 / 100

no-repository

provenance55

liveness100

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-100% +updated-11d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://emissaoja.com.br/mcp` streamable-http	none	yes	100%	1005 ms	2025-11-25	2026-11-07

Tools (16)

`acompanhar_operacao`read-only	Estado de uma operação (cancelamento): processando, concluida ou falhou (com o erro).
`acompanhar_pedido`read-only	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_nota`destructive	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_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_cnpj`read-only	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_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_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.
`listar_notas`read-only	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`read-only	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`read-only	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.
`minha_empresa`read-only	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_fiscais`read-only	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_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_credencial`read-only	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`read-only	Diz se o emissaoja está no ar e como está o motor fiscal. Sem chave.
`validar_cnpj`read-only	Confere formato e dígitos verificadores de um CNPJ, sem consultar nada. Sem chave.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "br.com.emissaoja/nfse",
  "title": "emissaoja · NFS-e",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://emissaoja.com.br/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional. Bearer ej_live_... API key; without it, clients with OAuth sign in with Google. Test keys (ej_test_) work only at https://sandbox.emissaoja.com.br/mcp"
        }
      ]
    }
  ],
  "version": "0.1.0",
  "websiteUrl": "https://emissaoja.com.br/emitir-nota-fiscal-por-ia",
  "description": "Issue Brazilian service invoices (NFS-e) via Emissor Nacional, no digital certificate"
}