8 prompts reais
Pede. Funciona.
Você digita em português. O agente escolhe a tool certa, chama a NFE.io e responde. Oito exemplos reais do que seu Claude (ou Cursor, VS Code, Continue, Windsurf) passa a fazer quando você conecta o mcp.nfe.io.
português natural
schemas validados
zero glue code
5 tools
Exemplos reais
Copia qualquer um, cola no teu agente, roda.
Cada card mostra o que você digita, qual tool o agente escolhe sozinho, e a resposta devolvida. Sem adivinhação de parâmetro, sem alucinação de nome de campo — o agente segue o schema que o servidor MCP expõe.
Prompt 01
lookup_cnpj
"Confirma se o CNPJ 12.345.678/0001-90 está ativo e me passa a razão social e o CNAE principal."
nfeio_lookup_cnpj({ cnpj: "12345678000190" })
ACME Tecnologia Ltda. Situação:
Active. CNAE principal: 62.01-5-01 — Desenvolvimento de programas de computador sob encomenda. Abertura: 2014-08-22.
Prompt 02
lookup_address
"Me dá o endereço completo do CEP 01310-100 com código IBGE da cidade."
nfeio_lookup_address({ postalCode: "01310100" })
Av. Paulista, Bela Vista, São Paulo/SP. Código IBGE:
3550308. Useful pra preencher endereço de tomador em emissão de NFS-e.
Prompt 03
list_service_invoices
"Lista as 20 últimas notas emitidas pela empresa abc-123 no mês passado."
nfeio_list_service_invoices({
companyId: "abc-123",
pageCount: 20,
issuedBegin: "2026-03-01",
issuedEnd: "2026-03-31"
})
companyId: "abc-123",
pageCount: 20,
issuedBegin: "2026-03-01",
issuedEnd: "2026-03-31"
})
20 notas no período. Total faturado: R$ 284.500. Maior tomador: XYZ Ltda (7 notas, R$ 98.000). Notas emitidas: 18. Rejeitadas: 2.
Prompt 04
get_invoice_status
"Aquela nota xyz-456 que emiti ontem, já foi processada pela prefeitura?"
nfeio_get_invoice_status({
companyId: "abc-123",
invoiceId: "xyz-456"
})
companyId: "abc-123",
invoiceId: "xyz-456"
})
Sim. Status:
Issued. Número RPS: 1428. Autorizada pela prefeitura em 2026-04-15 14:22. Link do PDF disponível no campo pdfUrl.
Prompt 05
issue_service_invoice · lookup_cnpj · lookup_address
"Emite uma NFS-e de R$ 1.500 de consultoria, código de serviço 2690, pro tomador CNPJ 11222333000181 — completa os dados dele com o que conseguir via consulta."
nfeio_lookup_cnpj(...) // pega razão social, endereço
nfeio_lookup_address(...) // enriquece CEP
nfeio_issue_service_invoice({ ... })
nfeio_lookup_address(...) // enriquece CEP
nfeio_issue_service_invoice({ ... })
Nota emitida. Número: 2026/1429. Valor: R$ 1.500,00. ISS: 5% (R$ 75,00). Tomador: ACME Ltda (São Paulo/SP). Link:
nfe.io/inv/2026-1429.
Prompt 06
get_invoice_status · list_service_invoices
"Tem alguma nota minha travada em processamento há mais de 24h?"
nfeio_list_service_invoices(...) // busca últimos dias
nfeio_get_invoice_status(...) // pra cada pendente
nfeio_get_invoice_status(...) // pra cada pendente
Duas notas com status
WaitingReturn há mais de 24h. IDs: inv-201, inv-207. Prefeitura: Campinas (atrasos frequentes). Sugiro aguardar mais 2h antes de abrir ticket.
Prompt 07
lookup_cnpj
"Valida esses 3 CNPJs antes de eu emitir nota pra eles: 11.111.111/0001-11, 22.222.222/0001-22, 33.333.333/0001-33."
nfeio_lookup_cnpj × 3 // em paralelo
CNPJ 1: ativo. ✅ CNPJ 2: suspenso desde 2025-12. ⚠️ Não recomendo emitir. CNPJ 3: não encontrado na base da Receita — provavelmente inválido.
Prompt 08
list_service_invoices
"Gera um CSV com todas as notas do 1º trimestre da empresa abc-123 que posso abrir no Excel."
nfeio_list_service_invoices(...) // paginando até cobrir 90 dias
143 notas no período. CSV com colunas: número, data, tomador (CNPJ + razão social), valor, ISS, status. Pronto pra download ou colar numa planilha.
Nota técnica: em todos os prompts acima o agente escolheu a tool sozinho — você não precisa lembrar o nome nfeio_lookup_cnpj nem memorizar schemas. O MCP server expõe descrições em linguagem natural que o LLM lê no handshake inicial, e a partir daí ele sabe quando chamar cada tool.
O que torna isso possível
Por que o agente não alucina parâmetro com MCP.
Cada tool do servidor expõe schema validado, descrição detalhada e mensagens de erro acionáveis. Se o LLM tentar chutar, a validação corta antes de chegar na API — e o agente recebe uma mensagem dizendo exatamente o que corrigir.
Validação Zod
schema
LLM tenta:
cnpj: "123"ValidationError: "CNPJ must be exactly 14 digits with no punctuation"
Agente corrige: formata pro padrão
12345678000190 e reexecuta. Zero ida-e-volta com você.
Descrições pra agente
prompt engineering
Cada tool vem com: "Use when: [cenários] · Do NOT use when: [antiпadrões] · Returns: [schema do output]"
O LLM lê isso no handshake inicial antes da primeira chamada.
Resultado: agente sabe que
issue_service_invoice é destrutivo e pede confirmação antes de emitir nota fiscal real.Teste agora
Copia um desses prompts e cola no teu agente.
Conectar leva 30 segundos: uma linha de config com https://mcp.nfe.io/mcp e sua API key no header. Qualquer um dos 8 prompts acima passa a funcionar imediatamente.