MCP NFS-e
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NFSE_CNPJ | No | CNPJ da empresa (opcional, útil para identificar a empresa em consultas). | |
| NFSE_SENHA | Yes | Senha do portal ISSWeb/Fiorilli para autenticação. | |
| NFSE_USUARIO | Yes | Usuário do portal ISSWeb/Fiorilli para autenticação. | |
| NFSE_PERMITIR_EMISSAO | No | Define como 'true' para permitir o modo emissão (preview) com dupla trava. | |
| NFSE_INSCRICAO_MUNICIPAL | No | Inscrição municipal da empresa (opcional). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nfse_statusA | Mostra a configuracao e testa a conexao com o WebService Nacional de NFS-e de Ariquemes. A consulta e aberta (nao exige login nem certificado). |
| nfse_consultar_por_chaveA | Consulta uma NFS-e pela chave de acesso (50 digitos, aceita com ou sem espacos). Metodo mais confiavel. Retorna todos os dados da nota. |
| nfse_consultar_por_numeroA | Consulta uma NFS-e pelo numero do DPS (e serie) do prestador configurado. Observacao: para notas emitidas pelo portal, prefira a consulta por chave. |
| nfse_consultar_por_id_dpsA | Consulta uma NFS-e pelo Id do DPS (ex.: "DPS1100023..."). |
| nfse_obter_xmlA | Retorna o XML bruto (bloco NFSe, layout nacional) de uma nota pela chave de acesso. |
| nfse_consultar_cnpjA | Busca os dados cadastrais de uma empresa pelo CNPJ (razao social, endereco, etc.) em base publica. Util para preencher os dados do tomador antes da emissao. |
| nfse_buscar_notasB | Lista as NFS-e emitidas num periodo, direto no portal da prefeitura (login/senha). Datas em AAAA-MM-DD ou dd/MM/aaaa. Filtro opcional por faixa de numero. Ideal para escritorios de contabilidade baixarem as notas de um cliente. |
| nfse_baixar_notaA | Baixa o XML e a DANFSe (PDF) de uma nota (pelo numero). Precisa do periodo que contem a nota. |
| nfse_baixar_periodoA | Baixa, em lote, o XML de todas as notas de um periodo para uma pasta. Ideal para escritorios de contabilidade fecharem a competencia de um cliente. |
| nfse_listar_empresasA | Lista as empresas configuradas no clientes.json, sem expor as senhas. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool serves a distinct purpose: status check, query by different identifiers (key, number, ID DPS), raw XML retrieval, CNPJ lookup, listing and downloading notes by period, and listing configured companies. Overlap is minimal and descriptions clarify differences, so an agent can readily select the correct tool.
All tools follow a consistent `nfse_` prefix and snake_case, but the verb usage varies (consultar, obter, buscar, baixar, listar, status). While readable and predictable, there is slight inconsistency in how similar actions are named (e.g., consultar vs. buscar).
With exactly 10 tools, the server is well-scoped for its purpose—covering status, queries, downloads, and configuration listing without redundancy. This is within the ideal 3–15 range and each tool earns its place.
The tool surface covers the core lifecycle of consulting and downloading NFS-e documents, including CNPJ lookup and bulk period downloads. The only notable gap is the lack of an emission (create) tool, but the server appears intentionally read-only for accounting use cases, so this is acceptable.