SendNF MCP server
Commit Nov 7, 2026Allows an AI client to issue, cancel, and manage NFS-e, NFC-e, and NF-e electronic invoices through conversational commands.
Also known as sendnf/sendnf-mcp, sendnf-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 7, 2026
- License
- —
What is SendNF MCP?
SendNF allows an AI client to issue, cancel, and manage NFS-e, NFC-e, and NF-e electronic invoices through conversational commands.
Summary generated from the project's README
About SendNF MCP server
SendNF provides a remote MCP server that enables AI agents to manage Brazilian electronic invoices through conversational commands. It supports the issuance, cancellation, and management of NFS-e, NFC-e, and NF-e documents. Developers can connect to the server via a streamable HTTP endpoint using a Bearer token for authentication. The system distinguishes between testing environments using keys starting with nt_test and production environments using nt_live keys.
The server includes a wide array of tools for handling the entire fiscal lifecycle. Users can perform CNPJ lookups, validate XML layouts, and manage digital certificates like A1 or proxy certificates. It offers specialized functions for simulating documents through preview tools before actual transmission to avoid errors. Beyond simple issuance, the server handles complex tasks such as issuing substitute documents, registering correction letters for NF-e, and generating bulk exports of XML and PDF files in ZIP format.
Written from the project's README. Every use case is checked against a quote from it.
How to install SendNF MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SendNF MCP in Claude Code
$ claude mcp add --transport http sendnf-mcp https://api.sendnf.com/mcpInstall SendNF MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sendnf-mcp": {
"url": "https://api.sendnf.com/mcp"
}
}
}Install SendNF MCP in VS Code
.vscode/mcp.json
{
"servers": {
"sendnf-mcp": {
"type": "http",
"url": "https://api.sendnf.com/mcp"
}
}
}Install SendNF MCP in VS Code CLI
$ code --add-mcp '{"name":"sendnf-mcp","type":"http","url":"https://api.sendnf.com/mcp"}'Install SendNF MCP in Codex
$ codex mcp add sendnf-mcp --url https://api.sendnf.com/mcpInstall SendNF MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.sendnf-mcp] url = "https://api.sendnf.com/mcp"
Install SendNF MCP in Gemini CLI
$ gemini mcp add -s user --transport http sendnf-mcp https://api.sendnf.com/mcpInstall SendNF MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sendnf-mcp": {
"url": "https://api.sendnf.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesendnf/sendnf-mcp is public and reachablegithub.com/sendnf/sendnf-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-07github.com/sendnf/sendnf-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSendNF 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/
- API para desenvolvedores: https://sendnf.com/desenvolvedores/ ; preços: https://sendnf.com/precos/ ; emissão de NFS-e: https://sendnf.com/nfse/
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 (44)
| 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. |
validate_dps |
leitura | Confere o XML de uma DPS (NFS-e Nacional) contra o leiaute oficial (XSD da NT 009) e devolve cada erro em português com o campo, o caminho, a causa e a correção. Não grava o XML, não chama a prefeitura nem a Receita e não garante aceitação: valida só o leiaute. Máximo 200 KB. |
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). |
upload_proxy_certificate |
escrita | Envia o e-CNPJ A1 do procurador (ex.: escritório contábil) uma vez; ele serve várias empresas da conta que derem procuração eletrônica. |
list_proxy_certificates |
leitura | Lista os certificados A1 de procurador da conta, a validade e as empresas que emitem com cada um. |
link_proxy_certificate |
escrita | Liga empresas ao certificado do procurador (Simples Nacional, com procuração eletrônica do serviço NFS-e já dada). |
unlink_proxy_certificate |
escrita | Desliga empresas do certificado do procurador; elas voltam a usar o A1 enviado para cada uma. |
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. |
preview_nfe |
leitura | Simula a NF-e modelo 55 (venda de mercadoria para empresa ou pessoa, dentro ou fora do estado; Simples Nacional e MEI) sem transmitir: valida destinatário, CFOP, transporte e pagamento no XSD oficial e lista problemas com guias. |
issue_nfe |
escrita | Emite a NF-e modelo 55 e espera até ~25 s pela SEFAZ. Passe reference para não duplicar ao repetir. O CFOP vira 6xxx sozinho na venda para outro estado; com e-mail no destinatário, o DANFE e o XML seguem para ele quando autorizada. Simples e MEI não destacam DIFAL (ADI 5464); regime normal (Presumido e Real) ainda não está disponível. Em produção, a empresa precisa estar ativada (veja go_live_status). |
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, |
correct_nfe |
escrita | Registra uma carta de correção (evento 110110) numa NF-e autorizada, para erro de dado que não muda valor, destinatário nem data de emissão. Até 20 cartas por nota; a SEFAZ guarda só a última. Para cancelar a NF-e (até 24 h), use cancel_document. |
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. |
SendNF MCP questions
How do I add SendNF MCP to Claude Code?
Run claude mcp add --transport http sendnf-mcp https://api.sendnf.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add SendNF MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I authenticate with the SendNF server?
You must use Bearer authentication with an API key. Use keys starting with 'nt_test_' for testing (no fiscal value) and 'nt_live_' for production.
Can I simulate an invoice before issuing it?
Yes, the server provides preview tools for NFS-e, NFC-e, and NF-e to validate layouts and calculate totals without transmitting them to tax authorities.
What happens if I need to correct an error in an authorized NF-e?
You can use the correct_nfe tool to register a correction letter (evento 110110) for data errors that do not change the value, recipient, or emission date.