Sendnf

io.github.sendnfPublished by GitHub account sendnfv1.0.0Updated Oct 29, 2026

Emita NFS-e e NFC-e conversando: CNPJ, código de serviço, pré-emissão, emissão e cancelamento.

VerifiedStreamable HTTPWeb executableFinanceDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

Remote SendNF MCP server that lets an assistant look up Brazilian company and service-code data and issue, preview, cancel or correct NFS-e, NFC-e and NF-e…

What you can do
  • Look up CNPJ data, national service codes (cTribNac/NBS) and how to obtain fiscal credentials
  • Manage issuing companies: list, create, update, import from existing XML, upload A1 certificate, check readiness and onboarding links
  • Preview and issue NFS-e, NFC-e and NF-e, then retry, cancel, substitute or correct them
  • Track documents: status, rejection reasons, event timelines, pending approvals and drafts awaiting human sign-off
  • Export invoices in bulk as ZIP plus CSV/XLSX and create, list or revoke read-only share links
  • Review account usage, billing estimates, go-live status and whitelabel branding
When to use it
Useful for Brazilian businesses, accountants or integrators that want an AI assistant to prepare, validate and issue service or goods invoices, or to check what is missing before a company can issue real notes.
Requirements
Remote Streamable HTTP endpoint at api.sendnf.com/mcp; no local install. Requires a SendNF account and a bearer key in the Authorization header: an nt_test_ key for homologation or an nt_live_ key for production. Without a key the server returns 401.
Before you install
The key grants access to a real invoicing account; a live key issues legally binding documents. Many tools write: creating companies, uploading the A1 certificate with its password, issuing, cancelling, substituting and correcting invoices, and creating share links. Issuing may incur charges. Share links expose invoices to anyone holding the link. Test keys carry no fiscal value.

Installation

In SourceWeft

  1. Open Sendnf in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.sendnf%2Fsendnf/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "sendnf": {
      "type": "http",
      "url": "https://api.sendnf.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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.

Este repositório tem só o manifesto, exemplos e a lista de ferramentas. O código do produto é privado.

Configuração

json
{  "mcpServers": {    "sendnf": {      "type": "http",      "url": "https://api.sendnf.com/mcp",      "headers": { "Authorization": "Bearer nt_test_SUA_CHAVE" }    }  }}

Ferramentas (40)

FerramentaTipoO que faz
account_overviewleituraModo 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_companyleituraNotas 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_statusleituraPor 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_cnpjleituraBusca 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_codesleituraBusca na lista nacional de serviços (LC 116) o código de tributação nacional (cTribNac, 6 dígitos) e o NBS.
get_service_codeleituraDescrição oficial de um código de tributação nacional e os NBS possíveis.
how_to_getleituraPasso a passo para conseguir dados fiscais difíceis de achar (CSC por UF, inscrição municipal, senha da prefeitura), com fontes oficiais.
validate_dpsleituraConfere 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_companiesleituraEmpresas emitentes da conta (id, CNPJ, nome, regime, cidade, external_id e metadata).
find_company_by_external_idleituraDados e checklist da empresa pelo id dela no sistema do integrador (external_id).
get_companyleituraDados 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_companyescritaCadastra a empresa emitente.
import_invoiceescritaLê 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_companyescritaAtualiza 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_certificateescritaEnvia o certificado digital A1 (.pfx em base64 + senha).
check_readinessleituraO que falta para a empresa emitir, com guias.
create_onboarding_linkescritaGera 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_brandingleituraWhitelabel 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_linkescritaCria 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_linksleituraLista os links de compartilhamento de notas: empresa, período, validade, se está ativo, expirado ou revogado, último acesso e quantos acessos.
revoke_share_linkescritaRevoga um link de compartilhamento: ele para de abrir na hora.
preview_nfseleituraSimula 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_nfseescritaEmite a NFS-e e espera até ~25 s pelo resultado (authorized, rejected, blocked ou pending).
preview_nfceleituraSimula a NFC-e (venda de produto ao consumidor) sem transmitir e lista problemas com guias.
issue_nfceescritaEmite a NFC-e e espera até ~25 s pelo resultado.
preview_nfeleituraSimula 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_nfeescritaEmite 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_documentsleituraNotas do modo atual, mais recentes primeiro.
get_documentleituraStatus 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_exportescritaPede 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_exportleituraEstado 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_eventsleituraLinha do tempo da nota (criada, enviada, autorizada, rejeitada, bloqueada, cancelada…), para explicar ao usuário o que aconteceu com ela.
cancel_documentescritaCancela a nota inteira na Receita/prefeitura/SEFAZ.
get_substitution_draftleituraDiz 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_documentescrita"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_nfeescritaRegistra 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_draftescritaMonta 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_approvalsleituraRascunhos de emissão, cancelamento e substituição do modo atual, mais recentes primeiro.
get_approval_statusleituraEstado 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_documentescritaTransmite 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.

Source: README.md at commit c01f88a

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.0.0LatestOct 29, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.