How do I use MCP Nota Fiscal?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Nota Fiscal Lista as últimas 5 notas fiscais emitidas" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Nota Fiscal

by rodrigo-do-carmo

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

MCP Nota Fiscal 🇧🇷

MCP Server para Nota Fiscal Eletrônica brasileira (NF-e, NFC-e, NFS-e).

Conecte seu assistente de IA ao sistema de notas fiscais do Brasil. Consulte CNPJs, emita notas, cancele, gere PDFs do DANFE — tudo via linguagem natural.

Tools disponíveis

Tool	Descrição
`consultar_cnpj`	Consulta dados públicos de CNPJ na Receita Federal
`status_sefaz`	Verifica disponibilidade da Sefaz por UF
`listar_nfe`	Lista NF-e emitidas por um CNPJ
`consultar_nfe`	Detalhes de uma NF-e específica
`emitir_nfe`	Emite uma nova NF-e
`cancelar_nfe`	Cancela NF-e (até 24h)
`carta_correcao_nfe`	Carta de Correção para NF-e
`baixar_pdf_nfe`	Download do DANFE em PDF
`baixar_xml_nfe`	Download do XML assinado
`inutilizar_nfe`	Inutiliza faixa de numeração
`listar_nfse`	Lista NFS-e emitidas
`consultar_nfse`	Detalhes de uma NFS-e
`emitir_nfse`	Emite uma nova NFS-e
`cancelar_nfse`	Cancela NFS-e
`consultar_empresa`	Dados da empresa na Nuvem Fiscal
`cadastrar_empresa`	Cadastra empresa para emissão

Related MCP server: peru-invoice-mcp

Setup

1. Obter token da Nuvem Fiscal

Crie uma conta em nuvemfiscal.com.br e gere um token de API.

2. Configurar no Claude Code

Adicione ao seu claude_desktop_config.json ou settings.json:

{
  "mcpServers": {
    "nota-fiscal": {
      "command": "npx",
      "args": ["-y", "@rodrigodocarmo/mcp-nota-fiscal"],
      "env": {
        "NUVEM_FISCAL_TOKEN": "seu-token-aqui",
        "NUVEM_FISCAL_SANDBOX": "true"
      }
    }
  }
}

3. Usar via npm local

npm install @rodrigodocarmo/mcp-nota-fiscal

Variáveis de ambiente

Variável	Obrigatória	Descrição
`NUVEM_FISCAL_TOKEN`	Sim	Token de acesso da API Nuvem Fiscal
`NUVEM_FISCAL_SANDBOX`	Não	`true` (padrão) ou `false` para produção

Exemplos de uso

"Consulta o CNPJ 00.000.000/0001-91"

"Lista as últimas 5 notas fiscais da minha empresa"

"Verifica se a Sefaz de SP está online"

"Cancela a nota fiscal X com justificativa Y"

Desenvolvimento

git clone https://github.com/rodrigo-do-carmo/mcp-nota-fiscal
cd mcp-nota-fiscal
npm install
npm run dev    # watch mode
npm run build  # compilar

Licença

MIT

Available Tools

16 tools

baixar_pdf_nfeA

Baixa o PDF do DANFE de uma NF-e

Inputs: id (required).

baixar_xml_nfeB

Baixa o XML assinado de uma NF-e

Inputs: id (required).

cadastrar_empresaA

Cadastra uma nova empresa na Nuvem Fiscal para emissão de notas fiscais

Inputs: dados (required).

cancelar_nfeA

Cancela uma NF-e autorizada (deve ser feito em até 24h após a autorização)

Inputs: id (required), justificativa (required).

cancelar_nfseA

Cancela uma NFS-e emitida

Inputs: id (required), justificativa (required).

carta_correcao_nfeA

Emite uma Carta de Correção (CC-e) para uma NF-e autorizada. Não pode corrigir valores, CFOP, ou dados que alterem o cálculo do imposto

Inputs: id (required), correcao (required).

consultar_cnpjA

Consulta dados públicos de um CNPJ na Receita Federal (razão social, endereço, situação cadastral, atividades)

Inputs: cnpj (required).

consultar_empresaB

Consulta dados de uma empresa cadastrada na Nuvem Fiscal

Inputs: cpf_cnpj (required).

consultar_nfeA

Consulta os detalhes de uma NF-e específica pelo ID

Inputs: id (required).

consultar_nfseA

Consulta os detalhes de uma NFS-e específica pelo ID

Inputs: id (required).

emitir_nfeA

Emite uma nova Nota Fiscal Eletrônica (NF-e). Requer os dados completos da nota em formato JSON conforme layout da Nuvem Fiscal

Inputs: dados (required).

emitir_nfseA

Emite uma nova Nota Fiscal de Serviço Eletrônica (NFS-e). Requer os dados completos em formato JSON

Inputs: dados (required).

inutilizar_nfeA

Inutiliza uma faixa de numeração de NF-e que não será utilizada (ex: falhas de sequência)

Inputs: ano (required), serie (required), cpf_cnpj (required), numero_final (required), +3 more.

listar_nfeB

Lista as NF-e emitidas por um CNPJ/CPF

Inputs: cpf_cnpj (required), top, skip, ambiente.

listar_nfseA

Lista as NFS-e (Nota Fiscal de Serviço Eletrônica) emitidas por um CNPJ/CPF

Inputs: cpf_cnpj (required), top, skip.

status_sefazA

Verifica se o serviço da Sefaz está online para uma UF específica

Inputs: uf (required), ambiente.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.6/5.0

Scored 2026-08-10 08:15 across 16 tools

Disambiguation4/5

Tools are clearly separated by document type (NF-e vs NFS-e) and action (emit, cancel, list, consult, download). The only potential confusion is between consultar_empresa and consultar_cnpj, but their descriptions clarify distinct purposes (internal registration vs public CNPJ data).

Naming Consistency4/5

Most tools follow a verb_noun pattern (emitir_nfe, cancelar_nfse, listar_nfe). Two exceptions stand out: status_sefaz (noun-first) and carta_correcao_nfe (noun phrase), but the majority are consistently patterned.

Tool Count4/5

16 tools cover both NF-e and NFS-e workflows, company management, and Sefaz status. This is just above the ideal 3-15 range, but each tool serves a distinct purpose without redundancy, making the count reasonable.

Completeness4/5

The NF-e lifecycle is thoroughly covered (emit, cancel, list, consult, download PDF/XML, inutilize, correction letter). NFS-e lacks download PDF/XML, and company management lacks update/delete, but these are minor gaps that agents can work around.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

NotaMCPA
io.github.CssEoCAO
Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.
Finance Payments & Billing
101
https://notamcp.com.br/mcp
StackinA
io.github.stackin-io
Issue and manage Brazilian fiscal documents: NF-e for goods, NFS-e for services.
Finance Payments & Billing ERP Systems
161
https://mcp.stackin.io/mcp
Brazil Invoices (NFS-e nota fiscal de serviço)A
app.wishpool
Brazil NFS-e service invoices for AI agents via Focus NFe and NFe.io. Stateless, never stores data.
Finance Payments & Billing
2
https://inv-br.wishpool.app/mcp
Conflaro
io.conttrole
Brazilian e-invoicing (NF-e, NFC-e, NFS-e): issue, cancel and query fiscal documents, plus AP/AR.
Finance ERP Systems
1
https://mcp.conflaro.com/mcp

Related MCP Servers

Mexico Invoice MCP
Finance Payments & Billing
junter1989k-ai
A
license
Not graded
quality
B
maintenance
Enables AI agents to issue Mexico CFDI 4.0 electronic invoices (factura electrónica) via Facturapi, with tools for creating, querying, canceling, and sending invoices.
Updated 4 months ago (2026-07-11 05:47 UTC)
MIT
peru-invoice-mcp
Payments & Billing Finance
junter1989k-ai
A
license
Not graded
quality
B
maintenance
Enables AI agents to issue Peruvian electronic invoices (factura/boleta) declared to SUNAT via Nubefact. Supports creating, querying, and canceling invoices with automatic IGV tax computation.
Updated 4 months ago (2026-07-11 05:48 UTC)
MIT
Paraguay Invoice MCP
Finance Payments & Billing
junter1989k-ai
A
license
Not graded
quality
C
maintenance
Enables AI agents to issue and query Paraguay SIFEN e-Kuatia electronic invoices through FacturaSend, handling IVA math and stateless forwarding.
Updated 4 months ago (2026-07-11 05:47 UTC)
MIT
cnpj-br
Government Data Open Data
pipeworx-io
A
license
Not graded
quality
B
maintenance
Brazilian company-registry lookup via Receita Federal, allowing AI agents to query CNPJ data.
Updated 10 days ago (2026-10-31 08:22 UTC)
306 npm
MIT

MCP Nota Fiscal 🇧🇷

Tools disponíveis

Setup

1. Obter token da Nuvem Fiscal

2. Configurar no Claude Code

3. Usar via npm local

Variáveis de ambiente

Exemplos de uso

Desenvolvimento

Licença

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Mexico Invoice MCP

peru-invoice-mcp

Paraguay Invoice MCP

cnpj-br