# 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