Content
# 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.
Powered by [Nuvem Fiscal](https://www.nuvemfiscal.com.br/) API.
## 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 |
## Setup
### 1. Obter token da Nuvem Fiscal
Crie uma conta em [nuvemfiscal.com.br](https://www.nuvemfiscal.com.br/) e gere um token de API.
### 2. Configurar no Claude Code
Adicione ao seu `claude_desktop_config.json` ou `settings.json`:
```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
```bash
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
```bash
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
