Sendnf

io.github.sendnf由 GitHub 账号 sendnf 发布v1.0.0更新于 Oct 29, 2026

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

已验证Streamable HTTP可网页运行金融开发者工具商业与电商

概览

AI 生成的概览

SendNF 远程 MCP 服务器,让助手查询巴西企业与服务税码,并预览、开具、取消或更正 NFS-e、NFC-e 和 NF-e 发票。

可以做什么
  • 查询 CNPJ 企业公开数据、国家服务税码(cTribNac/NBS)及获取财税凭证的步骤
  • 管理开票企业:列出、创建、更新、从已有 XML 导入、上传 A1 证书、检查就绪状态与生成入驻链接
  • 预览并开具 NFS-e、NFC-e 和 NF-e,并支持重试、取消、替换或更正
  • 跟踪单据:状态、拒绝原因、事件时间线、待审批草稿与人工确认
  • 批量导出票据为 ZIP 及 CSV/XLSX,创建、列出或撤销只读分享链接
  • 查看账户用量、费用估算、上线状态与白标品牌设置
适用场景
适合巴西企业、会计或集成商,希望由 AI 助手准备、校验并开具服务或商品发票,或在正式开票前检查企业还缺哪些条件。
运行要求
远程 Streamable HTTP 端点 api.sendnf.com/mcp,无需本地安装。需要 SendNF 账户,并在 Authorization 请求头中提供 Bearer 密钥:nt_test_ 为测试环境,nt_live_ 为生产环境。无密钥时服务器返回 401。
安装前请注意
该密钥可访问真实开票账户,生产密钥开具的票据具有法律效力。多个工具会写入数据:创建企业、上传含密码的 A1 证书、开具、取消、替换和更正发票、创建分享链接。开票可能产生费用。分享链接会让持链接者看到发票。测试密钥无财税效力。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Sendnf,将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.sendnf%2Fsendnf/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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.

来源:README.md,提交 c01f88a

工具

0
该服务器需要 API 密钥等凭据,因此 SourceWeft 无法在没有凭据的情况下读取其工具,也未收录。

版本历史

1
  1. v1.0.0最新Oct 29, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。