{"_id":"@codespar/mcp-nfe-io","_rev":"5-819854628220b935dd8402f78eec0a21","name":"@codespar/mcp-nfe-io","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-nfe-io","version":"0.1.0","keywords":["mcp","nfe-io","nfe","nfse","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nfe-io@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nfe-io":"dist/index.js"},"dist":{"shasum":"051d059e409a907c671fcafdcf5508e84a13c0b6","tarball":"https://registry.npmjs.org/@codespar/mcp-nfe-io/-/mcp-nfe-io-0.1.0.tgz","fileCount":7,"integrity":"sha512-KiF6gLr868x0azs0PdUgEBfv6kRVGGkh8Nitmoxsq2oFKTodyME3UhEC1dA73Bp9qeEqh/4xcY3S7XrGBOqClA==","signatures":[{"sig":"MEYCIQD/41Kr10COz2RKmBS//LzvdVQhucm7bAfLtyQYUO5KEgIhALv/jLYoRCRgzJz8zw+IqYFX54WhNgqAqdA6KBvoptQ9","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":50031},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"9fd666923d39389fd517c9bf2e3cedfcaaa72b4e","mcpName":"io.github.codespar/mcp-nfe-io","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.7","description":"MCP server for NFe.io — NF-e, NFS-e, 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-nfe-io_0.1.0_1776880708998_0.5803587323727593","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-nfe-io","version":"0.2.0","keywords":["mcp","nfe-io","nfe","nfse","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nfe-io@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nfe-io":"dist/index.js"},"dist":{"shasum":"be12cdfad7ea3b30fbc7c40f1b23c103bb6f638d","tarball":"https://registry.npmjs.org/@codespar/mcp-nfe-io/-/mcp-nfe-io-0.2.0.tgz","fileCount":7,"integrity":"sha512-J+Y+9SYFft305QISu0RgCOUnKAyyz36s1NKT+Tn8OyIEALzyQzeVqZzGy4QAhmxyhgm26ciqEI2wL0F2u+bJtQ==","signatures":[{"sig":"MEQCIHyEog7vvFopumvn4VsaL3dDWOsvZ3DxDu1IgZJhQGBHAiA7bVcxz46GsBgUxIIm9nCO3gk15SXKofnxywqOGdwTjg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":70902},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"4e5eee18d53ee8475a69a3fb27a8d2cde35c99f9","mcpName":"io.github.codespar/mcp-nfe-io","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for NFe.io — NF-e, NFS-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-nfe-io_0.2.0_1777042151713_0.7575517415931763","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-nfe-io","version":"0.2.1","keywords":["mcp","nfe-io","nfe","nfse","cnpj","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-nfe-io@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nfe-io":"dist/index.js"},"dist":{"shasum":"df1cb5a6224dc2fb3eddbb2fb9e376770c009cd9","tarball":"https://registry.npmjs.org/@codespar/mcp-nfe-io/-/mcp-nfe-io-0.2.1.tgz","fileCount":7,"integrity":"sha512-Mbym7LdHWvI59FIVCB4jI4I/WDOFd8MdDCruR3sF/A+eLl0qWC4++tQP0hPo5bSO6FXY5Y6FrT8+8HRIlFPRtA==","signatures":[{"sig":"MEUCIHSy1YNtBuOpC3e1nznptZZ8FbAZGS43DFtEUPMlOnr+AiEAmSjit2AkKASTkqVr3CscCBfZiE+UGaZrWWZz1CSx274=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71652},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-nfe-io","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for NFe.io — NF-e, NFS-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-nfe-io_0.2.1_1777123087401_0.738272096340256","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-nfe-io","version":"0.2.2","description":"MCP server for NFe.io — NF-e, NFS-e, CNPJ, CEP","type":"module","main":"./dist/index.js","bin":{"mcp-nfe-io":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","nfe-io","nfe","nfse","cnpj","cep","brazil"],"mcpName":"io.github.codespar/mcp-nfe-io","_id":"@codespar/mcp-nfe-io@0.2.2","gitHead":"776ee260ec81f40a78c5f23f4ae78d64b475c0fa","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-7jbEZAbPK5TVdjPfmS7FS6+zXK3w81KXywq+ZKPfIBivuqes04FISzwY/B9on+wKN4rmCnw2FUPzdm0ZuhWYXg==","shasum":"da819149a5e2a807a2e49ca16f1c9442f7ed932f","tarball":"https://registry.npmjs.org/@codespar/mcp-nfe-io/-/mcp-nfe-io-0.2.2.tgz","fileCount":7,"unpackedSize":73476,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF255KUIZpZQlePQq/5VVqQK3pVV6JYgDDjrE28B9XB5AiEAq8GwBDUxoP5VjCJqsVry1/I24k3IFGM9f60/Mip5PBc="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-nfe-io_0.2.2_1782149672543_0.8576539606181919"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-22T17:58:28.910Z","modified":"2026-06-22T17:34:32.850Z","0.1.0":"2026-04-22T17:58:29.151Z","0.2.0":"2026-04-24T14:49:11.850Z","0.2.1":"2026-04-25T13:18:07.518Z","0.2.2":"2026-06-22T17:34:32.697Z"},"license":"MIT","keywords":["mcp","nfe-io","nfe","nfse","cnpj","cep","brazil"],"description":"MCP server for NFe.io — NF-e, NFS-e, CNPJ, CEP","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-nfe-io\n\n> MCP server for **NFe.io** — NF-e / NFS-e fiscal document emission plus CNPJ and CEP lookups for Brazil.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-nfe-io)](https://www.npmjs.com/package/@codespar/mcp-nfe-io)\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    \"nfe-io\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-nfe-io\"],\n      \"env\": {\n        \"NFEIO_API_KEY\": \"your-api-key\",\n        \"NFEIO_COMPANY_ID\": \"your-company-id-or-cnpj\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add nfe-io -- npx @codespar/mcp-nfe-io\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"nfe-io\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-nfe-io\"],\n      \"env\": {\n        \"NFEIO_API_KEY\": \"your-api-key\",\n        \"NFEIO_COMPANY_ID\": \"your-company-id-or-cnpj\"\n      }\n    }\n  }\n}\n```\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `create_nfse` | Issue an NFS-e (service invoice). |\n| `get_nfse` | Fetch a single NFS-e by id. |\n| `cancel_nfse` | Cancel an NFS-e. |\n| `list_nfse` | List NFS-e with pagination + optional flowStatus filter. |\n| `email_nfse` | Email the PDF of an already-issued NFS-e to a recipient. |\n| `create_nfe` | Issue an NF-e (product invoice). |\n| `get_nfe` | Fetch a single NF-e by id. |\n| `cancel_nfe` | Cancel an NF-e. |\n| `list_nfe` | List NF-e with pagination + optional status filter. |\n| `get_nfe_pdf` | Return the DANFE PDF URL for an issued NF-e. |\n| `consult_cnpj` | Look up Brazilian company data (razão social, status, address) by CNPJ. |\n| `consult_cep` | Resolve a Brazilian postal code (CEP) to a full address. |\n| `correct_nfe` | Issue a Carta de Correção (CC-e) for an authorized NF-e. |\n| `get_nfe_xml` | Return the authorized XML URL for an NF-e. |\n| `get_nfse_pdf` | Return the PDF URL for an issued NFS-e. |\n| `get_nfse_xml` | Return the XML URL for an issued NFS-e. |\n| `list_companies` | List companies registered on the NFe.io account. |\n| `get_company` | Fetch a single company by id or CNPJ. |\n| `create_company` | Provision a new company on NFe.io. |\n| `list_webhooks` | List webhook endpoints registered for a company (invoice event callbacks). |\n| `create_webhook` | Register a webhook endpoint. |\n| `delete_webhook` | Remove a webhook endpoint by id. |\n\n## Environment\n\n| Variable | Required | Notes |\n|---|---|---|\n| `NFEIO_API_KEY` | yes | Issuance + query scopes. NFe.io supports splitting this into two keys; either is fine. |\n| `NFEIO_COMPANY_ID` | no | Default company id (or CNPJ). Per-call `company_id` arguments override it. |\n\n## Hosts\n\nNFe.io segments its API across three hostnames. This server maps tools to the correct one automatically:\n\n- `api.nfse.io` — product invoices\n- `api.nfe.io` — service invoices + company management\n- `nfe.api.nfe.io` — lookups (CNPJ, CEP)\n\n## Demo mode\n\nPass `--demo` or set `MCP_DEMO=true` to return canned responses without hitting the network. Useful for documentation, screencasts, and CI.\n\n## Links\n\n- [NFe.io REST API docs](https://nfe.io/docs/rest-api/)\n- [CodeSpar MCP Brazil catalog](https://github.com/codespar/mcp-dev-latam)\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## Authentication\n\nSet these environment variables before launching the server:\n\n- `NFEIO_API_KEY` *(required, secret)* — API key for NFe.io (issuance + query)\n- `NFEIO_COMPANY_ID` — Default company ID (CNPJ or NFe.io company UUID) to use when not provided per-call\n\nIssue credentials at the provider's developer portal: <https://nfe.io/docs>.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}