io.github.sendnf/sendnf
Emita NFS-e e NFC-e conversando: CNPJ, código de serviço, pré-emissão, emissão e cancelamento.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
Remote (streamable-http)
Claude Code
claude mcp add --transport http sendnf 'https://api.sendnf.com/mcp' --header 'Authorization: <Bearer nt_test_... (homologação) ou nt_live_...>'Configuration JSON (Claude Desktop, Cursor, VS Code)
{
"mcpServers": {
"sendnf": {
"type": "http",
"url": "https://api.sendnf.com/mcp",
"headers": {
"Authorization": "<Bearer nt_test_... (homologação) ou nt_live_...>"
}
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
SendNF MCP
Servidor MCP do SendNF: emita NFS-e e NFC-e conversando com o seu agente de IA. Consulta de CNPJ, código de serviço, pré-emissão, emissão e cancelamento.
- URL:
https://api.sendnf.com/mcp(Streamable HTTP, sem sessão) - Autenticação:
Authorization: Bearer <chave>. Chavent_test_...é homologação (sem valor fiscal);nt_live_...é produção. Sem chave, o servidor responde 401. - Documentação: https://sendnf.com/mcp/
Este repositório tem só o manifesto, exemplos e a lista de ferramentas. O código do produto é privado.
Configuração
{
"mcpServers": {
"sendnf": {
"type": "http",
"url": "https://api.sendnf.com/mcp",
"headers": { "Authorization": "Bearer nt_test_SUA_CHAVE" }
}
}
}Ferramentas (36)
| Ferramenta | Tipo | O que faz |
|---|---|---|
account_overview | leitura | Modo da chave (teste ou produção), plano, uso do mês, se a chave é restrita a uma empresa e as empresas cadastradas com o que falta em cada uma. |
usage_by_company | leitura | Notas de cada empresa no período (por tipo, status e ambiente), notas reais autorizadas, se o CNPJ ficou ativo e a estimativa de cobrança de cada uma. |
go_live_status | leitura | Por empresa: se o checklist da NFS-e está completo, se já passou uma nota de teste, se está ativada para emitir notas reais (live_enabled_at) e o estado |
lookup_cnpj | leitura | Busca dados públicos da empresa na Receita (razão social, endereço, CNAE, Simples/MEI), descobre se a prefeitura usa o Sistema Nacional ou sistema próprio e sugere códigos de serviço pelo CNAE. |
search_service_codes | leitura | Busca na lista nacional de serviços (LC 116) o código de tributação nacional (cTribNac, 6 dígitos) e o NBS. |
get_service_code | leitura | Descrição oficial de um código de tributação nacional e os NBS possíveis. |
how_to_get | leitura | Passo a passo para conseguir dados fiscais difíceis de achar (CSC por UF, inscrição municipal, senha da prefeitura), com fontes oficiais. |
list_companies | leitura | Empresas emitentes da conta (id, CNPJ, nome, regime, cidade, external_id e metadata). |
find_company_by_external_id | leitura | Dados e checklist da empresa pelo id dela no sistema do integrador (external_id). |
get_company | leitura | Dados da empresa, dados públicos da Receita e o checklist do que falta para emitir NFS-e e NFC-e, com guia para cada pendência. |
create_company | escrita | Cadastra a empresa emitente. |
import_invoice | escrita | Lê o XML de uma nota que a empresa já emitiu (NFS-e Nacional ou municipal, NF-e ou NFC-e) e cadastra ou completa a empresa: inscrições, regime, código de serviço, NBS, alíquota do ISS, código municipal e a numeração (série e próximo número). |
update_company | escrita | Atualiza dados da empresa (ex.: inscrição municipal, código de serviço padrão, CSC da NFC-e, senha da prefeitura, emits_nfce, external_id, metadata; null apaga external_id e metadata). |
upload_certificate | escrita | Envia o certificado digital A1 (.pfx em base64 + senha). |
check_readiness | leitura | O que falta para a empresa emitir, com guias. |
create_onboarding_link | escrita | Gera um link curto da página de cadastro da empresa (com o whitelabel da conta, se ligado), para o próprio dono completar o que falta: certificado A1 e senha, |
get_branding | leitura | Whitelabel da conta: se está ligado, nome, logo, cor, e-mail de suporte, responder-para, origens que podem incorporar o cadastro e o domínio de envio dos e-mails (com o status do DNS). |
create_share_link | escrita | Cria um link seguro, só de leitura, para quem recebe (contabilidade, sócio ou outro sistema) ver e baixar as notas autorizadas e canceladas (PDF, XML e ZIP do mês), sem login. |
list_share_links | leitura | Lista os links de compartilhamento de notas: empresa, período, validade, se está ativo, expirado ou revogado, último acesso e quantos acessos. |
revoke_share_link | escrita | Revoga um link de compartilhamento: ele para de abrir na hora. |
preview_nfse | leitura | Simula a NFS-e sem transmitir: valida contra o layout oficial (ou o provedor da prefeitura), calcula totais e IBS/CBS e lista problemas com guias. |
issue_nfse | escrita | Emite a NFS-e e espera até ~25 s pelo resultado (authorized, rejected, blocked ou pending). |
preview_nfce | leitura | Simula a NFC-e (venda de produto ao consumidor) sem transmitir e lista problemas com guias. |
issue_nfce | escrita | Emite a NFC-e e espera até ~25 s pelo resultado. |
list_documents | leitura | Notas do modo atual, mais recentes primeiro. |
get_document | leitura | Status e detalhes de uma nota: motivo de rejeição explicado, blocked_reason, tentativas de envio (attempts, max_attempts, next_attempt_at, last_error), se ainda pode ser cancelada ou substituída (cancellation) e links de PDF/XML. |
create_export | escrita | Pede a exportação em massa: um ZIP com o XML e o PDF de todas as notas do período (pastas por empresa e mês) e a planilha notas.csv/notas.xlsx (número, data, tomador, CPF/CNPJ, valor, ISS, retenções, situação, chave). |
get_export | leitura | Estado de uma exportação (queued, running, ready, failed, expired), progresso (done/total) e, quando pronta, download_url (link assinado de 1 hora; o arquivo fica guardado 7 dias). |
get_document_events | leitura | Linha do tempo da nota (criada, enviada, autorizada, rejeitada, bloqueada, cancelada…), para explicar ao usuário o que aconteceu com ela. |
cancel_document | escrita | Cancela a nota inteira na Receita/prefeitura/SEFAZ. |
get_substitution_draft | leitura | Diz se a NFS-e pode ser corrigida por substituição ("cancelar parcialmente") e devolve o corpo da original para editar e mandar ao substitute_document. |
substitute_document | escrita | "Cancelar parcialmente" ou corrigir valor/dados de uma NFS-e: emite uma nota substituta com os itens e valores informados, apontando para a original, |
create_note_draft | escrita | Monta uma NFS-e (kind nfse) ou NFC-e (kind nfce) e deixa aguardando aprovação humana, mesmo que a trava esteja desligada: valida como na emissão (cadastro, layout oficial, totais) e devolve o rascunho com id, status pending_approval, approval_url e, na NFS-e, preview_pdf_url (prévia sem valor fiscal). |
list_pending_approvals | leitura | Rascunhos de emissão, cancelamento e substituição do modo atual, mais recentes primeiro. |
get_approval_status | leitura | Estado do rascunho: pending_approval (esperando uma pessoa), approved (traz o documento emitido/cancelado), rejected (traz rejection_reason: corrija e monte de novo), expired (ninguém decidiu em 7 dias) ou failed (aprovado, mas a emissão deu erro; veja error). |
retry_document | escrita | Transmite agora uma nota pending, blocked (depois de corrigir o que faltava) ou failed ("Não enviada", quando o SendNF desistiu de tentar) e espera até ~25 s pelo resultado. |
Questions fréquentes
Qu'est-ce que io.github.sendnf/sendnf ?
Emita NFS-e e NFC-e conversando: CNPJ, código de serviço, pré-emissão, emissão e cancelamento.
Comment installer io.github.sendnf/sendnf ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http sendnf 'https://api.sendnf.com/mcp' --header 'Authorization: <Bearer nt_test_... (homologação) ou nt_live_...>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.sendnf/sendnf ?
Oui. Il attend Authorization, à renseigner dans sa configuration.
io.github.sendnf/sendnf est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.sendnf/sendnf ?
Il est publié par sendnf. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.