# Nota Fiscal

### Nota Fiscal for Claude, ChatGPT and AI agents

Issue and manage Brazilian service invoices (NFS-e) by chatting with your agent, platform-hosted, no nfe.io account needed. Connect your CNPJ + A1 certificate and issue, query, download (PDF/XML) and cancel NFS-e.

- 📊 **6 tools**
- ✏️ **Read and write**
- 💬 **Works with any MCP client**: Claude Desktop, Cursor, VS Code, Cline, Continue
- 🔑 **Magic-link login (no password)**

[Versão em português](README.pt.md) · [Full docs (PT-BR)](docs/) · [Agent skill](skills/)

---

## One-click install

### Claude (Web and Desktop)

Anthropic unified MCP installation at `claude.ai/customize/connectors`. **The same link works for Claude Web and Claude Desktop** (just be logged in):

[➕ Open in Claude and connect](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors)

**Manual** (if the deeplink does not open): [claude.ai/customize/connectors](https://claude.ai/customize/connectors?surface=cowork) → **+** → **Add custom connector** → paste **Name** `Nota Fiscal` and **URL** `https://api.mcp.ai/p_notafiscal`.

### Cursor

[➕ Install Nota Fiscal in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=notafiscal&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9ub3RhZmlzY2FsIn0=)

### VS Code (Copilot Chat)

[➕ Install Nota Fiscal in VS Code](vscode:mcp/install?name=notafiscal&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mcp.ai%2Fp_notafiscal%22%7D)

### ChatGPT, Manus, OpenClaw and 40+ other clients

Works with any MCP client that speaks **MCP over HTTP**. The server URL is always:

```
https://api.mcp.ai/p_notafiscal
```

Per-client details: [INSTALL.md](INSTALL.md).

---

## Example prompts

```
Issue a R$1,500 consulting NFS-e for client X's CNPJ
List the NFS-e I issued this month
Download the PDF and XML for invoice XYZ
```

---

## 6 tools available

| Tool | Description |
|---|---|
| `notafiscal_empresas` | Lista as empresas (CNPJs) conectadas a este install e a situação de cada uma (company_id, razão social, município, validade do certificado). |
| `notafiscal_emitir_nfse` | Emite uma NFS-e (nota fiscal de serviço) para uma empresa conectada. |
| `notafiscal_consultar_nfse` | Consulta o status/detalhe de uma NFS-e emitida, por invoice_id. |
| `notafiscal_listar_nfse` | Lista as NFS-e emitidas por uma empresa (paginado). |
| `notafiscal_baixar_nfse` | Retorna os links de PDF (DANFSe) e XML de uma NFS-e emitida. |
| `notafiscal_cancelar_nfse` | Cancela uma NFS-e emitida (IRREVERSÍVEL, sujeito ao prazo de cancelamento do município). |

Details for each tool: [docs/ferramentas.md](docs/ferramentas.md) (PT-BR)

---

## Pricing

Prepaid credit wallet, pay per use. See [docs/precos.md](docs/precos.md) (PT-BR).

---

## Privacy & data protection

- **Sub-processors**: nfe.io, the LLM host you choose (Claude, ChatGPT, Cursor, your own agent). Full list in [docs/privacidade-lgpd.md](docs/privacidade-lgpd.md).
- Data returned by the tools is sent to **the LLM host you choose**, a sub-processor outside our control. We recommend plans with training opt-out.

---

## FAQ

**Is the server open source?**
The server is proprietary (hosted). This repository is the public wrapper with manifests, docs and skills, all MIT.

**Can I use it with my own agent (not Claude/Cursor)?**
Yes, any client that speaks MCP over HTTP. URL: `https://api.mcp.ai/p_notafiscal`.


---

## Support

- 📧 [notafiscal@mcp.ai](mailto:notafiscal@mcp.ai)
- 🐛 [GitHub Issues](https://github.com/mcp-dir/notafiscal-mcp/issues)
- 📄 [docs/](docs/)

---

## License

MIT — see [LICENSE](LICENSE). The MCP server at `api.mcp.ai/p_notafiscal` is proprietary (hosted); this repo (manifests, docs, skills) is MIT.