{"_id":"@codespar/mcp-nuvem-fiscal","_rev":"8-0d344a0ee91ddf7e1ed65cd36f668cae","name":"@codespar/mcp-nuvem-fiscal","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@codespar/mcp-nuvem-fiscal","version":"0.1.0","keywords":["mcp","nuvem-fiscal","nfe","nfse","nfce","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nuvem-fiscal@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nuvem-fiscal":"dist/index.js"},"dist":{"shasum":"51467c9449c84a757f5bf46d0319367153239e8e","tarball":"https://registry.npmjs.org/@codespar/mcp-nuvem-fiscal/-/mcp-nuvem-fiscal-0.1.0.tgz","fileCount":4,"integrity":"sha512-/f4Xswc+6Oo9aNRYwCOUtsBK8jE4Owjp/cziE8TgqRWsxe/AET4yckUWemWbTfPqqDAWSugkiMVVN5sHkVP2nQ==","signatures":[{"sig":"MEUCIHxpCFBKRwjmLOXKJYrDY3K/fPWgkctq3wrNmSWOkscnAiEAlxDmclUuEDsqVHCsT1fk7LJHlAgxUb7MDB5amndXpCQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21874},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ac49d04d5aa50ad5dc16233f0bba88213f917641","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nuvem Fiscal — NF-e, NFS-e, NFC-e, CNPJ, CEP","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nuvem-fiscal_0.1.0_1774923324093_0.4072489949068694","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Service discontinued 2026-07-31; use @codespar/mcp-nfe-io instead"},"0.1.2":{"name":"@codespar/mcp-nuvem-fiscal","version":"0.1.2","keywords":["mcp","nuvem-fiscal","nfe","nfse","nfce","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nuvem-fiscal@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nuvem-fiscal":"dist/index.js"},"dist":{"shasum":"8da74b605ef82b7a916a52dbd4d06a89a434f77f","tarball":"https://registry.npmjs.org/@codespar/mcp-nuvem-fiscal/-/mcp-nuvem-fiscal-0.1.2.tgz","fileCount":7,"integrity":"sha512-Ja0z9jsgF4hN/lIrf3tpFg1dYUFplReFwUnoryqu5oUD9Z+MQEP97TJIyf96IKQe3djSD7B4YTJzvVegUg8VWw==","signatures":[{"sig":"MEYCIQC9fwVhlvcq6/MfSN4kp87r3wYBZklyPLjbEJzaIiDdJwIhAPEUbnUe9y8Gb/jpF90tlu4O5ha2GkDyN/YkKbNCYKHc","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40991},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-nuvem-fiscal","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nuvem Fiscal — NF-e, NFS-e, NFC-e, CNPJ, CEP","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nuvem-fiscal_0.1.2_1775953724989_0.8844696924116273","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Service discontinued 2026-07-31; use @codespar/mcp-nfe-io instead"},"0.2.0":{"name":"@codespar/mcp-nuvem-fiscal","version":"0.2.0","keywords":["mcp","nuvem-fiscal","nfe","nfse","nfce","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nuvem-fiscal@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nuvem-fiscal":"dist/index.js"},"dist":{"shasum":"80eb7e726a3fb58965be2333bb2627978724395e","tarball":"https://registry.npmjs.org/@codespar/mcp-nuvem-fiscal/-/mcp-nuvem-fiscal-0.2.0.tgz","fileCount":7,"integrity":"sha512-TuwaKp9Lhwf0N6JW5m+WGyUv2KNKPfu983fkTbKMFOKT7LWNJ++L4kgfnuHBQKzCQrKVWJKfBPc90g3Rd/04uQ==","signatures":[{"sig":"MEYCIQDLR0rCEk/YBWiSXVxUwiC52ZNAYHxqbTPsvRo5YsBICAIhAI8eIqxuNQwnG2KmceV/7wfkFzP66Q3Qoug9fRNNRE2y","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58164},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b999d2a16b58ff41c781890e346d04a59801d6cb","mcpName":"io.github.codespar/mcp-nuvem-fiscal","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nuvem Fiscal — NF-e, NFS-e, NFC-e, CT-e, MDF-e, CCe, lotes, empresas, certificados, CNPJ, CEP","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nuvem-fiscal_0.2.0_1777039114092_0.38637877225326056","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Service discontinued 2026-07-31; use @codespar/mcp-nfe-io instead"},"0.2.1":{"name":"@codespar/mcp-nuvem-fiscal","version":"0.2.1","keywords":["mcp","nuvem-fiscal","nfe","nfse","nfce","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nuvem-fiscal@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nuvem-fiscal":"dist/index.js"},"dist":{"shasum":"291b0520088ae20193ca74674e87d222958f9a1b","tarball":"https://registry.npmjs.org/@codespar/mcp-nuvem-fiscal/-/mcp-nuvem-fiscal-0.2.1.tgz","fileCount":7,"integrity":"sha512-Kkbimzkj7Ir+BXrDSm1sSJWJI5h7qcIRDnXsu8G8oF3Fu8yPF6kScJb7u3KTXCGbpvJFp50g7B0/erpd7/U7cA==","signatures":[{"sig":"MEUCIHJMiRe9SfbIIuoKbYodG0pJo3BqCAckmPiRmaoOob3rAiEAwP8VAVkFpcbTFKfwsnKWfMT/eM9rBt6NpiNPOEpnvbg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59097},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-nuvem-fiscal","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nuvem Fiscal — NF-e, NFS-e, NFC-e, CT-e, MDF-e, CCe, lotes, empresas, certificados, CNPJ, CEP","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nuvem-fiscal_0.2.1_1777123091044_0.7051037365677202","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Service discontinued 2026-07-31; use @codespar/mcp-nfe-io instead"},"0.3.0":{"name":"@codespar/mcp-nuvem-fiscal","version":"0.3.0","keywords":["mcp","nuvem-fiscal","nfe","nfse","nfce","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nuvem-fiscal@0.3.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nuvem-fiscal":"dist/index.js"},"dist":{"shasum":"351ed62b1f94b33dd90ef3a0233e855042765d8e","tarball":"https://registry.npmjs.org/@codespar/mcp-nuvem-fiscal/-/mcp-nuvem-fiscal-0.3.0.tgz","fileCount":8,"integrity":"sha512-eWyTXtAuMkdjtrOv5jy10/qFSFxt4LiH9lXgPxZdYXt7DTvVYtC8fZTgzWc7ia4CYKF56V7I3rse9rcpQOTyVg==","signatures":[{"sig":"MEUCIQDLVTy+0xPD5HY5AkBwE8wTUbdOt5jPU/d6xReFWNk6ggIgcv4wfQTzqXiKdFYOL7jGGmSJw6gufqhPZFEmS77x2mc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64014},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"9e869cb61cb9fd1da3cadba588e1a68c27d51278","mcpName":"io.github.codespar/mcp-nuvem-fiscal","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.7","description":"MCP server for Nuvem Fiscal — NF-e, NFS-e, NFC-e, CT-e, MDF-e, CCe, lotes, empresas, certificados, CNPJ, CEP","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nuvem-fiscal_0.3.0_1779022786453_0.02354332422606409","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Service discontinued 2026-07-31; use @codespar/mcp-nfe-io instead"},"0.3.1":{"name":"@codespar/mcp-nuvem-fiscal","version":"0.3.1","keywords":["mcp","nuvem-fiscal","nfe","nfse","nfce","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nuvem-fiscal@0.3.1","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"bin":{"mcp-nuvem-fiscal":"dist/index.js"},"dist":{"shasum":"526586caaac093136a001d2383a478d372f7d42e","tarball":"https://registry.npmjs.org/@codespar/mcp-nuvem-fiscal/-/mcp-nuvem-fiscal-0.3.1.tgz","fileCount":8,"integrity":"sha512-06uQWFfi3oB/5VMrlnyMa3HhQzfvO3Ka08Evh646zAPopVXeFoeUzG4U1GovOi5cy5s83+G/dLSKIgmgVakguQ==","signatures":[{"sig":"MEQCIBQI0qeuVlTFs84Y2AYj8XsEIzVnEOah2aujZQUhOQr9AiB60VbSZ6qM3DEb7wzw/kSpZC3OfZ9L0F30YSszBkJ0CQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64982},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","mcpName":"io.github.codespar/mcp-nuvem-fiscal","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"_npmVersion":"10.9.8","description":"MCP server for Nuvem Fiscal — NF-e, NFS-e, NFC-e, CT-e, MDF-e, CCe, lotes, empresas, certificados, CNPJ, CEP","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nuvem-fiscal_0.3.1_1782153650002_0.9125962122213975","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Service discontinued 2026-07-31; use @codespar/mcp-nfe-io instead"}},"time":{"created":"2026-03-31T02:15:23.999Z","modified":"2026-07-08T15:04:13.857Z","0.1.0":"2026-03-31T02:15:24.237Z","0.1.2":"2026-04-12T00:28:45.126Z","0.2.0":"2026-04-24T13:58:34.217Z","0.2.1":"2026-04-25T13:18:11.215Z","0.3.0":"2026-05-17T12:59:46.629Z","0.3.1":"2026-06-22T18:40:50.153Z"},"license":"MIT","keywords":["mcp","nuvem-fiscal","nfe","nfse","nfce","cnpj","cep","brazil"],"description":"MCP server for Nuvem Fiscal — NF-e, NFS-e, NFC-e, CT-e, MDF-e, CCe, lotes, empresas, certificados, CNPJ, CEP","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-nuvem-fiscal\n\n> MCP server for **Nuvem Fiscal** — NFe, NFSe, NFCe fiscal document emission and CNPJ/CEP lookup\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-nuvem-fiscal)](https://www.npmjs.com/package/@codespar/mcp-nuvem-fiscal)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"nuvem-fiscal\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-nuvem-fiscal\"],\n      \"env\": {\n        \"NUVEM_FISCAL_CLIENT_ID\": \"your-client-id\",\n        \"NUVEM_FISCAL_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add nuvem-fiscal -- npx @codespar/mcp-nuvem-fiscal\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"nuvem-fiscal\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-nuvem-fiscal\"],\n      \"env\": {\n        \"NUVEM_FISCAL_CLIENT_ID\": \"your-client-id\",\n        \"NUVEM_FISCAL_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Tools (24)\n\n| Tool | Purpose |\n|---|---|\n| `create_nfe` | Create a NF-e (nota fiscal eletrônica) |\n| `get_nfe` | Get NF-e details by ID |\n| `cancel_nfe` | Cancel a NF-e |\n| `create_nfse` | Create a NFS-e (nota fiscal de serviço eletrônica) |\n| `get_nfse` | Get NFS-e details by ID |\n| `cancel_nfse` | Cancel a NFS-e |\n| `create_nfce` | Create a NFC-e (nota fiscal de consumidor eletrônica) |\n| `consult_cnpj` | Consult company data by CNPJ number |\n| `consult_cep` | Consult address by CEP (postal code) |\n| `register_company` | Register a company in Nuvem Fiscal |\n| `create_cte` | Create a CT-e (conhecimento de transporte eletrônico) |\n| `get_cte` | Get CT-e details by ID |\n| `cancel_cte` | Cancel a CT-e |\n| `create_mdfe` | Create a MDF-e (manifesto de documentos fiscais eletrônico) |\n| `get_nfe_events` | Get events for a NF-e (cancellations, corrections, etc.) |\n| `cancel_nfce` | Cancel a NFC-e (nota fiscal de consumidor eletrônica) |\n| `send_correction_letter_nfe` | Send a carta de correção eletrônica (CCe) for a NF-e. |\n| `send_correction_letter_cte` | Send a carta de correção for a CT-e. |\n| `get_nfe_batch` | Get NF-e batch (lote) status by batch ID. |\n| `get_mdfe` | Get MDF-e details by ID |\n| `cancel_mdfe` | Cancel a MDF-e (manifesto) |\n| `close_mdfe` | Close (encerrar) a MDF-e at route end. |\n| `list_empresas` | List all companies (empresas) registered in the account. |\n| `upload_certificate` | Upload or update an A1 digital certificate (.pfx, base64) for an empresa. |\n\n## Authentication\n\nNuvem Fiscal uses OAuth2 client credentials. The server automatically manages token refresh.\n\n## Sandbox / Testing\n\nNuvem Fiscal supports a homologation environment (ambiente=2) for testing fiscal document emission without affecting real tax systems.\n\n## Demo Mode\n\nSet `MCP_DEMO=true` (or pass `--demo`) to run the server without contacting the Nuvem Fiscal API. In `MCP_DEMO=true` mode, `create_nfse` issues distinct fixture IDs per call within one process and echoes input `servico.codigo`, `valor`, and `servico.descricao` into the response. `pdf_url` is templated from the fixture id. Other demo tools return static fixtures and are useful for offline walkthroughs and integration smoke tests.\n\n### Get your credentials\n\n1. Go to [Nuvem Fiscal Developer Portal](https://dev.nuvemfiscal.com.br)\n2. Create an account\n3. Register an application to get OAuth2 credentials\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `NUVEM_FISCAL_CLIENT_ID` | Yes | OAuth2 client ID |\n| `NUVEM_FISCAL_CLIENT_SECRET` | Yes | OAuth2 client secret |\n\n## Roadmap\n\n### v0.2 (planned)\n- `create_cte` — Create a CT-e (electronic transport document)\n- `get_cte` — Get CT-e details by ID\n- `cancel_cte` — Cancel an issued CT-e\n- `create_mdfe` — Create an MDF-e (electronic freight manifest)\n- `get_nfe_events` — Get events for an NF-e (cancellation, correction, etc.)\n\n### v0.3 (planned)\n- `batch_nfe` — Create multiple NF-e in a single request\n- `get_nfe_danfe` — Get DANFE PDF for an NF-e\n- `manifest_recipient` — Manifest recipient awareness of an NF-e\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [Nuvem Fiscal Website](https://nuvemfiscal.com.br)\n- [Nuvem Fiscal API Documentation](https://dev.nuvemfiscal.com.br)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}