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 分

    請在儲存庫或註冊中心條目中宣告授權條款。