Mcp Nfse Nacional
Connects to Brazil's national electronic service invoice portal (nfse.gov.br) using e-CNPJ or e-CPF digital certificates for authentication. Exposes three tools: nfse_buscar searches invoices by date range, nfse_detalhes pulls full invoice details and saves XML locally, and nfse_pdf downloads the DANFSe PDF. Handles session management automatically, reauthorizing when tokens expire. Requires a PFX/P12 certificate file and password via environment variables. Runs over stdio for direct Claude Desktop integration or as an HTTP server for remote access. Useful if you're building AI workflows around Brazilian fiscal documents and need programmatic access to issued NFSe data without manual portal navigation.
- GitHub stars
- 14
- tools
- 3
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 5
- last updated
- Feb 12, 2026
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
nfse_buscarBusca NFSe emitidas em um período. Retorna lista com data, destinatário, valor, status e chave de cada nota.
Busca NFSe emitidas em um período. Retorna lista com data, destinatário, valor, status e chave de cada nota.
No parameter schema in public metadata yet.
nfse_detalhesObtém os detalhes completos de uma NFSe a partir da sua chave. Retorna cabeçalho, emitente, valores, DPS e salva o XML localmente.
Obtém os detalhes completos de uma NFSe a partir da sua chave. Retorna cabeçalho, emitente, valores, DPS e salva o XML localmente.
No parameter schema in public metadata yet.
nfse_pdfBaixa o PDF (DANFSe) de uma NFSe a partir da sua chave. Retorna o caminho do arquivo PDF salvo localmente.
Baixa o PDF (DANFSe) de uma NFSe a partir da sua chave. Retorna o caminho do arquivo PDF salvo localmente.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
CERT_PASSWORD*secretSenha do certificado digital (e-CNPJ/e-CPF) em formato PFX
CERT_FILE*Caminho para o arquivo do certificado digital (.pfx)
NODE_OPTIONSdefault: --openssl-legacy-providerOpções do Node.js (use --openssl-legacy-provider para compatibilidade com certificados)
MCP_PORTdefault: 3000Porta do servidor HTTP
STORAGE_PATHdefault: ./storageDiretório onde os XMLs e PDFs baixados serão armazenados
Readme
mcp-nfse-nacional
MCP Server para consulta de Notas Fiscais de Serviço Eletrônicas (NFSe) no portal nacional (nfse.gov.br). Permite que agentes de IA autentiquem-se com certificado digital e-CNPJ/e-CPF e consultem, detalhem e baixem PDFs de NFSe emitidas.
Ferramentas disponíveis
O servidor expõe três ferramentas via protocolo MCP:
| Ferramenta | Descrição | Parâmetros |
|---|---|---|
nfse_buscar | Busca NFSe emitidas em um período. Retorna lista com data, destinatário, valor, status e chave de cada nota. | data_inicio (YYYY-MM-DD), data_fim (YYYY-MM-DD) |
nfse_detalhes | Obtém os detalhes completos de uma NFSe a partir da sua chave. Retorna cabeçalho, emitente, valores, DPS e salva o XML localmente. | chave (string) |
nfse_pdf | Baixa o PDF (DANFSe) de uma NFSe a partir da sua chave. Retorna o caminho do arquivo PDF salvo localmente. | chave (string) |
A autenticação é gerenciada automaticamente. O login é realizado na primeira chamada e, caso a sessão expire (erro de autenticação), uma nova tentativa de login é feita de forma transparente.
Variáveis de ambiente
Details
- Repository
- github.com/samuelmoraesf/mcp-nfse-nacional
- Package
mcp-nfse-nacional- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active