mcp-nfs-emissor
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
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 |
|---|---|
| configurar_prestadorA | Grava os dados fixos do afiliado (prestador/emitente) em config/prestador.json para reutilizar nas emissões. Use antes da primeira emissão ou para corrigir CNPJ/IM/LC116/ISS. O emitente é exclusivamente PJ (CNPJ 14 dígitos; CPF é recusado). Nunca grava token nem senha. |
| carregar_csvA | Lê um CSV mensal da Shopee (respeitando aspas no campo Endereço do Vendedor), filtra pedidos com Status válido {Pendente, Concluído} e comissão ≠ 0, e AGREGA por ID da Loja somando a comissão. Retorna a lista de vendedores (uma futura NFS-e por loja) e as contagens do funil. NÃO emite nada. |
| previsualizar_emissaoA | DRY-RUN: monta a tabela do que SERÁ emitido (tomador, valor, discriminação, código de serviço) para a competência já carregada, sem enviar ao provedor. Use para o usuário conferir e confirmar antes de emitir. |
| emitir_nfseA | Emite as NFS-e da competência (uma por loja) chamando o provedor. Exige confirmar: true. Respeita o modo (dry-run não envia; sandbox usa mock; producao emite de verdade e exige certificado A1, mas só via configuração do host). Idempotente por (idLoja + competência): não reemite quem já foi autorizada. Processa em BLOCOS e retorna progresso; salva PDFs/XMLs e atualiza o resumo.csv. |
| consultar_statusB | Consulta no provedor o status atual das notas de uma competência (útil quando a emissão é assíncrona: processando → autorizada/rejeitada). Atualiza o resumo.csv. |
| reprocessar_falhasA | Reemite APENAS as notas com status rejeitada/erro da competência, reaproveitando os dados já carregados. Exige confirmar: true. Também processa em blocos. Para rejeitada, corrija a causa (config/LC116/alíquota) antes. |
| listar_saidasA | Lista as competências (pastas AAAA-MM) já processadas em saidas/ e quantas notas cada uma tem. Read-only; use para ver o histórico antes de reprocessar. |
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 7 tools
Each tool addresses a distinct step in the NFS-e emission workflow: configuration, CSV loading, dry-run preview, actual emission, status checking, reprocessing failures, and listing historical outputs. There is no functional overlap.
All tool names follow a consistent verb_noun pattern in Portuguese (e.g., configurar_prestador, carregar_csv), using lowercase with underscores throughout. No naming style conflicts are present.
With 7 tools, the server covers all essential phases of batch NFS-e generation from setup to post-processing. The count is neither sparse nor excessive for the domain.
The tool set covers the core workflow (config, load, preview, emit, check status, reprocess failures, list history). A minor gap is the lack of a tool for individual note viewing or manual adjustment, but the overall lifecycle is well-supported.