NFe Hub

io.github.cristianosantanaPublished by GitHub account cristianosantanav1.0.0Updated Oct 24, 2026

Consulta status de NFe na SEFAZ pela chave de acesso: autorizada, cancelada, protocolo.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that lets an assistant look up the status of a Brazilian electronic invoice (NFe) at SEFAZ from its 44-digit access key.

What you can do
  • Query an NFe at SEFAZ using its 44-digit access key
  • Get the invoice situation (authorized, cancelled, denied) and the authorization protocol number
  • Get the date and time of authorization or cancellation
  • Optionally include linked events such as cancellation or correction letters
  • Optionally pass a CNPJ or receipt number to filter or validate the query
When to use it
Useful for accounting firms and tax departments that currently check invoice status manually on the SEFAZ portal or by asking clients, and want the answer inside the chat where the team already works.
Requirements
A remote streamable-HTTP endpoint; no package, environment variable or header is declared. The assistant needs network access to the hosted server and the 44-digit NFe access key for each query.
Before you install
The README states that the digital certificate and access credentials stay in the issuer integration and do not pass through the AI model, but no authentication is declared for the endpoint itself. Queries send invoice access keys and optional CNPJ data to a third-party hosted service, so confirm the provider's handling of that data before use.

Installation

In SourceWeft

  1. Open NFe Hub 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/io.github.cristianosantana%2Fmcp-nfe-hub-v1/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": {
    "nfe-hub": {
      "type": "http",
      "url": "https://mcp-nfe-hub.onrender.com/mcp"
    }
  }
}

README

Mcp NFe Hub

Descrição

O NFe Hub conecta assistentes de IA (Claude, ChatGPT etc.) diretamente à consulta oficial de Notas Fiscais Eletronicas na SEFAZ. A partir da chave de acesso de 44 digitos, retorna em segundos:

  • Situação da nota (autorizada, cancelada, denegada)
  • Número do protocolo de autorização
  • Data e hora da autorização/cancelamento
  • Eventos vinculados (cancelamento, carta de correção), quando solicitado

Feito para escritórios de contabilidade e departamentos fiscais que hoje conferem esse status manualmente no portal da SEFAZ ou trocando mensagens de WhatsApp com o cliente ("essa nota autorizou?"). Com o NFe Hub, a pergunta é respondida no mesmo chat onde o time já trabalha, sem precisar abrir outro sistema.

O certificado digital e as credenciais de acesso não passam pelo modelo de IA — ficam apenas na integração com o emissor.

Categoria/tags

fiscal, nfe, sefaz, contabilidade, brasil, tax, invoice, accounting, finance

Ferramenta exposta

consultar_nfe

  • chave_nfe (obrigatório): chave de acesso de 44 dígitos da NFe
  • cnpj (opcional): CNPJ para filtrar/validar a consulta
  • n_recibo (opcional): número de recibo, quando aplicável
  • retorna_eventos (opcional): se true, inclui eventos vinculados (cancelamento, CC-e)

Link do servidor remoto (para o campo "install"/"connect")

https://mcp-nfe-hub.onrender.com/mcp (tipo de transporte: streamable-http)

Repositório

https://github.com/cristianosantana/mcp-nfe-hub-v1

Source: README.md at commit ad846d0

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

75% 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

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.