English Français العربية

io.github.sendnf/sendnf

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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_...>'
إعداد 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_...>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على 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>. Chave nt_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)

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.
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.
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,
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.

الأسئلة الشائعة

ما هو io.github.sendnf/sendnf؟

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

كيف أثبّت io.github.sendnf/sendnf؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http sendnf 'https://api.sendnf.com/mcp' --header 'Authorization: <Bearer nt_test_... (homologação) ou nt_live_...>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.sendnf/sendnf إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.sendnf/sendnf مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.sendnf/sendnf؟

ينشره sendnf. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.