SendNF

Issue Brazilian NFS-e, NFC-e and NF-e invoices from an AI agent, with preview and human approval before issuing.

Hosted MCP Server

npx add-mcp 'https://api.sendnf.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Emita nota fiscal conversando com a IA

O SendNF tem um servidor MCP com 44 ferramentas. Conecte o Claude com a sua chave de API e peça a nota em português: a IA acha o código de serviço, pré-emite e só emite quando você confirma.

Resposta curta: Para emitir nota pelo Claude, crie uma chave de API no SendNF e adicione o servidor MCP https://api.sendnf.com/mcp com o header Authorization: Bearer <chave>. Depois é só pedir a nota na conversa.

Claude + servidor MCP do SendNFexemplo

Emite a nota da Acme: R$ 1.500 de desenvolvimento de software, referente a outubro.
Achou o código de serviço 01.01.01 (desenvolvimento de sistemas)
Pré-emitiu e conferiu no layout oficial
A nota está pronta: Acme Tecnologia, R$ 1.500,00, código 01.01.01, ISS de 2%. Você está em produção. Posso emitir?
Pode.
Emitiu na prefeitura: NFS-e nº 1042 autorizada
Emitida: NFS-e nº 1042. O PDF e o XML foram para financeiro@acme.com.br.

claude mcp add --transport http sendnf https://api.sendnf.com/mcp \
  --header "Authorization: Bearer nt_test_..."

Claude Desktop e outros clientes (JSON)

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

Como conectar

1
Crie a conta e uma chave de API
No painel do SendNF, em Desenvolvedores, crie uma chave nt_test_ para testar em homologação. Use nt_live_ quando quiser notas reais.
2
Adicione o servidor MCP
No Claude Code, rode o comando claude mcp add com a URL https://api.sendnf.com/mcp e o header Authorization. No Claude Desktop e em outros clientes, use a configuração JSON.
3
Peça a nota em português
Por exemplo: "emite a nota da Acme de R$ 1.500 de desenvolvimento". A IA pré-emite, mostra o resumo e emite quando você confirma.

As 44 ferramentas do servidor

As marcadas com escrita mudam algo na sua conta; as outras só leem.

Ferramenta	O que faz	Tipo
account_overview	Modo da chave (teste ou produção), plano, uso do mês, se a chave é restrita a uma empresa e o que falta em cada empresa.	leitura
usage_by_company	Notas de cada empresa no período, CNPJs ativos e a estimativa de cobrança de cada uma.	leitura
go_live_status	Por empresa: nota de teste aprovada, checklist e se já está ativada para emitir de verdade.	leitura
lookup_cnpj	Dados públicos da Receita, sistema da prefeitura e códigos de serviço sugeridos pelo CNAE.	leitura
search_service_codes	Busca na lista nacional de serviços por palavras do dia a dia ou pelo código.	leitura
get_service_code	Descrição oficial de um código e os NBS possíveis.	leitura
validate_dps	Confere o XML de uma DPS contra o leiaute oficial (XSD da NT 009) e explica cada erro com o campo, a causa e a correção. Não grava o XML.	leitura
how_to_get	Passo a passo para conseguir dados não públicos (certificado, CSC, inscrição municipal…).	leitura
list_companies	Empresas emitentes da conta, com filtro pelo external_id.	leitura
find_company_by_external_id	Acha a empresa pelo id dela no seu sistema (external_id), com o checklist.	leitura
get_company	Dados da empresa, dados públicos e o checklist com guias.	leitura
create_company	Cadastra a empresa só com o CNPJ (aceita external_id e metadata).	escrita
import_invoice	Lê o XML de uma nota antiga e cadastra ou completa a empresa (inscrições, códigos, numeração).	escrita
update_company	Atualiza inscrição municipal, código padrão, CSC, senha da prefeitura, NFC-e, external_id e metadata.	escrita
upload_certificate	Envia o certificado A1 fornecido pelo usuário.	escrita
upload_proxy_certificate	Envia o certificado A1 do procurador (ex.: escritório contábil), fornecido pelo usuário. Um arquivo serve várias empresas da conta.	escrita
list_proxy_certificates	Lista os certificados de procurador da conta, a validade e as empresas ligadas.	leitura
link_proxy_certificate	Liga empresas ao certificado do procurador: elas passam a emitir com ele.	escrita
unlink_proxy_certificate	Desliga empresas do procurador: voltam ao certificado delas.	escrita
check_readiness	O que falta para emitir NFS-e e NFC-e.	leitura
create_onboarding_link	Gera o link da página de cadastro para o próprio lojista completar o que falta.	escrita
get_branding	Mostra o whitelabel da conta e o status do domínio de envio.	leitura
create_share_link	Cria um link seguro, só de leitura, para quem recebe ver e baixar as notas (PDF, XML e ZIP do mês), com validade.	escrita
list_share_links	Lista os links de compartilhamento, com validade, último acesso e quantos acessos.	leitura
revoke_share_link	Revoga um link de compartilhamento: ele para de abrir na hora.	escrita
preview_nfse	Pré-emite a NFS-e sem transmitir.	leitura
issue_nfse	Emite a NFS-e e espera o resultado.	escrita
preview_nfce	Pré-emite a NFC-e sem transmitir.	leitura
issue_nfce	Emite a NFC-e e espera o resultado.	escrita
preview_nfe	Pré-emite a NF-e (modelo 55) sem transmitir.	leitura
issue_nfe	Emite a NF-e (modelo 55) e espera o resultado da SEFAZ.	escrita
correct_nfe	Registra uma carta de correção numa NF-e autorizada.	escrita
list_documents	Lista notas por empresa, status, tipo e referência.	leitura
get_document	Status, motivo de rejeição explicado, tentativas de envio, prazo de cancelamento e links de PDF e XML. Aceita também o id de um rascunho de aprovação.	leitura
create_export	Exportação em massa: ZIP com XML e PDF de todas as notas do período, por empresa e mês, e a planilha CSV/Excel.	escrita
get_export	Estado da exportação e o link assinado para baixar o ZIP quando estiver pronto.	leitura
get_document_events	Linha do tempo da nota: criada, enviada, autorizada, rejeitada, cancelada.	leitura
cancel_document	Cancela a nota inteira (irreversível, pede confirmação). NFC-e só em até 30 minutos depois da autorização.	escrita
get_substitution_draft	Diz se a NFS-e pode ser corrigida e devolve os dados dela para editar.	leitura
substitute_document	Cancela parcialmente ou corrige uma NFS-e emitindo a nota substituta (pede confirmação).	escrita
create_note_draft	Monta a NFS-e ou NFC-e e deixa aguardando aprovação humana, com a prévia em PDF. Nada vai ao órgão fiscal.	escrita
list_pending_approvals	Rascunhos aguardando aprovação (e os aprovados, recusados ou vencidos).	leitura
get_approval_status	Se o rascunho foi aprovado (com a nota emitida), recusado (com o motivo) ou venceu.	leitura
retry_document	Reenvia agora uma nota pendente, bloqueada ou não enviada.	escrita

Você no controle

Chave por modo
Uma chave nt_test_ nunca emite nota real. Teste à vontade antes de usar nt_live_.
Confirmação antes de emitir
As instruções do servidor pedem pré-emissão e confirmação antes de emitir ou cancelar em produção.
Segredos protegidos
Certificado, CSC e senhas da prefeitura ficam cifrados e nunca voltam nas respostas.

Quer entender o caso de uso por completo? Leia como emitir nota fiscal com IA.

Perguntas sobre o MCP

O que é MCP?

MCP (Model Context Protocol) é um protocolo aberto para conectar assistentes de IA a ferramentas externas. Com o servidor MCP do SendNF, a IA passa a consultar CNPJ, pré-emitir e emitir notas usando a sua chave de API.

Quais clientes funcionam?

Qualquer cliente compatível com MCP por HTTP (Streamable HTTP), como o Claude Code e o Claude Desktop. O servidor é sem sessão e responde em JSON.

A IA pode emitir nota sem eu pedir?

Ela só age com a chave que você configurou. As instruções do servidor mandam pré-emitir antes de emitir e confirmar com você antes de emitir ou cancelar em produção. Para testar sem risco, use uma chave nt_test_: tudo vai para homologação.

E se faltar um dado, como a inscrição municipal?

A ferramenta how_to_get traz o passo a passo oficial do SendNF para cada dado que não é público. O servidor orienta a IA a explicar como conseguir o dado em vez de inventá-lo.

Dá para emitir notas reais pelo MCP?

Sim, com uma chave nt_live_ e a empresa ativada para emitir de verdade, o que um administrador confirma no painel, em Produção, depois de uma nota de teste autorizada. A ferramenta go_live_status mostra em que pé cada empresa está.

Funciona com uma chave restrita a uma empresa?

Sim. O servidor MCP segue as mesmas regras da API: uma chave restrita só vê e emite pela empresa dela, não cadastra outras empresas e responde que não encontrou as demais.

E se a prefeitura estiver fora do ar?

A nota fica na fila e o SendNF tenta de novo sozinho. A IA vê as tentativas e o último erro em get_document e, se o SendNF desistir, reenvia com retry_document quando você pedir.

O MCP custa à parte?

Não. O servidor MCP está incluído em todos os planos e as notas emitidas por ele contam como qualquer outra nota.