{"_id":"@codespar/mcp-focus-nfe","_rev":"6-ccfe813d9f02182bb99969f7d8f1b347","name":"@codespar/mcp-focus-nfe","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-focus-nfe","version":"0.1.0","keywords":["mcp","focus-nfe","nfe","nfse","fiscal","brazil"],"license":"MIT","_id":"@codespar/mcp-focus-nfe@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-focus-nfe":"dist/index.js"},"dist":{"shasum":"329e2fcbbd43739357ed1ea6e62af6c6c6878cff","tarball":"https://registry.npmjs.org/@codespar/mcp-focus-nfe/-/mcp-focus-nfe-0.1.0.tgz","fileCount":4,"integrity":"sha512-mrMXd1GsQCcs76jgjm3no1Yb+rFphH0IpbZQIUMamo5T8H3ePvNyQ0js6Bh+7rrBWMzpFN5j49K/vC6PuWDzng==","signatures":[{"sig":"MEQCIDYTssoS8jfmZ+OMjT54YdB4F5K6HKjYCbdT28BFki+lAiB2OZ4XcovAOReIku6vfes2MAoEhTrrVAV3asQsKX/uvA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22777},"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 Focus NFe — NFe, NFSe, NFCe emission and management","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-focus-nfe_0.1.0_1774923321503_0.10306917624567213","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-focus-nfe","version":"0.1.2","keywords":["mcp","focus-nfe","nfe","nfse","fiscal","brazil"],"license":"MIT","_id":"@codespar/mcp-focus-nfe@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-focus-nfe":"dist/index.js"},"dist":{"shasum":"b230be96a05a0d6d41dab99270be2c0fc461b82d","tarball":"https://registry.npmjs.org/@codespar/mcp-focus-nfe/-/mcp-focus-nfe-0.1.2.tgz","fileCount":7,"integrity":"sha512-Lr3iAIc/TeHcp9kdAXpgBKuCoZ6/2UY6isKQfcGOnkTVzkCl+nCaB+udeLyBC9dgctHdPCiF69v5iTZcFM5nFQ==","signatures":[{"sig":"MEUCIH7baLCQkUAxKwHu+olhSG+xkqi7EAPgnBy58mYyeOELAiEAs+dv64y5Q8AAf3BfK880hHOk6wzf9VLhXeYOH/KrYqs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33104},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-focus-nfe","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Focus NFe — NFe, NFSe, NFCe emission and management","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-focus-nfe_0.1.2_1775953721399_0.10879070310485295","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-focus-nfe","version":"0.2.0","keywords":["mcp","focus-nfe","nfe","nfse","nfce","cte","mdfe","fiscal","brazil"],"license":"MIT","_id":"@codespar/mcp-focus-nfe@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-focus-nfe":"dist/index.js"},"dist":{"shasum":"09b6e80da902ed74c93f40240b097839e47404a7","tarball":"https://registry.npmjs.org/@codespar/mcp-focus-nfe/-/mcp-focus-nfe-0.2.0.tgz","fileCount":7,"integrity":"sha512-JXiLmsjOcA87lWgVOgMA2KmvP7FBd+eIF6U/Qnt0cc0KdtEz1V6zuRasbG4KqDDe63Jv4pvpigCqa391PMos/Q==","signatures":[{"sig":"MEUCIQCEsRaGV9vNqBVYXhPT8tq0JCOB8/dKRCTAaQHbig13IAIgHrLddRR2enSJDAX5FFpnghsYP8njYIpMX2YbrKcr66M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51786},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b999d2a16b58ff41c781890e346d04a59801d6cb","mcpName":"io.github.codespar/mcp-focus-nfe","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Focus NFe — NFe, NFSe, NFCe, CTe, MDFe emission, correction letters, and webhooks","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-focus-nfe_0.2.0_1777039117369_0.9736107325671484","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-focus-nfe","version":"0.2.1","keywords":["mcp","focus-nfe","nfe","nfse","nfce","cte","mdfe","fiscal","brazil"],"license":"MIT","_id":"@codespar/mcp-focus-nfe@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-focus-nfe":"dist/index.js"},"dist":{"shasum":"8a9a92663fed5ae18d45a0a5e5a80bf6da9f2171","tarball":"https://registry.npmjs.org/@codespar/mcp-focus-nfe/-/mcp-focus-nfe-0.2.1.tgz","fileCount":7,"integrity":"sha512-jB1OTCvLVfDQ92HcjSI4f392cVLSdRECQHGgiTHOs9w+KdQzzgSFs51JmVEuwI3umFP1nE7QuOHMaI611218Vg==","signatures":[{"sig":"MEYCIQCbsanOOh4TcZfMqRbrtJ6L3fyT8IieQ8jO9YFKJ530kwIhAPGMwMfU4WGuYmI6Z0Zr34vcutt4SO8p+y1HwGxAKvt6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52646},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-focus-nfe","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Focus NFe — NFe, NFSe, NFCe, CTe, MDFe emission, correction letters, and webhooks","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-focus-nfe_0.2.1_1777123083778_0.07600419608579756","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-focus-nfe","version":"0.2.2","description":"MCP server for Focus NFe — NFe, NFSe, NFCe, CTe, MDFe emission, correction letters, and webhooks","type":"module","main":"./dist/index.js","bin":{"mcp-focus-nfe":"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","focus-nfe","nfe","nfse","nfce","cte","mdfe","fiscal","brazil"],"mcpName":"io.github.codespar/mcp-focus-nfe","_id":"@codespar/mcp-focus-nfe@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-QcB2h4Nwh0OQiSBiw+JKMFJYGAg2sFspvmL9o5dvssJasg9Zd0KXm8RywzIx1XoaEfpQ+Qn5gZa9u+JIbYh8Rw==","shasum":"687629b586bf1e128072e8e951988e86d9261156","tarball":"https://registry.npmjs.org/@codespar/mcp-focus-nfe/-/mcp-focus-nfe-0.2.2.tgz","fileCount":7,"unpackedSize":53924,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCZD1DuAaIvRsSVbZmEv8IIawn5J+H91ZJ8QqBsyqfFjgIhAPHcw6tAKnmtY5Q0b8rdz7vHQnfraSeq3Ulalb3eBIAS"}]},"_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-focus-nfe_0.2.2_1782153641382_0.7153641531115587"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:21.379Z","modified":"2026-06-22T18:40:41.653Z","0.1.0":"2026-03-31T02:15:21.661Z","0.1.2":"2026-04-12T00:28:41.529Z","0.2.0":"2026-04-24T13:58:37.525Z","0.2.1":"2026-04-25T13:18:03.942Z","0.2.2":"2026-06-22T18:40:41.520Z"},"license":"MIT","keywords":["mcp","focus-nfe","nfe","nfse","nfce","cte","mdfe","fiscal","brazil"],"description":"MCP server for Focus NFe — NFe, NFSe, NFCe, CTe, MDFe emission, correction letters, and webhooks","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-focus-nfe\n\n> MCP server for **Focus NFe** — NFe, NFSe, and NFCe fiscal document emission\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-focus-nfe)](https://www.npmjs.com/package/@codespar/mcp-focus-nfe)\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    \"focus-nfe\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-focus-nfe\"],\n      \"env\": {\n        \"FOCUS_NFE_TOKEN\": \"your-token\",\n        \"FOCUS_NFE_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add focus-nfe -- npx @codespar/mcp-focus-nfe\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"focus-nfe\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-focus-nfe\"],\n      \"env\": {\n        \"FOCUS_NFE_TOKEN\": \"your-token\",\n        \"FOCUS_NFE_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n## Tools (19)\n\n| Tool | Purpose |\n|---|---|\n| `create_nfe` | Create and emit an NFe (nota fiscal eletronica) |\n| `get_nfe` | Get NFe details and status by reference |\n| `cancel_nfe` | Cancel an authorized NFe (within 24h of emission) |\n| `get_nfe_pdf` | Get NFe PDF (DANFE) download URL |\n| `send_correction_letter` | Send a correction letter (Carta de Correcao / CCe) for an authorized NFe |\n| `create_nfse` | Create and emit an NFSe (nota fiscal de servico) |\n| `get_nfse` | Get NFSe details and status by reference |\n| `cancel_nfse` | Cancel an authorized NFSe |\n| `create_nfce` | Create and emit an NFCe (nota fiscal do consumidor eletronica) |\n| `get_nfce` | Get NFCe details and status by reference |\n| `cancel_nfce` | Cancel an authorized NFCe |\n| `create_cte` | Create and emit a CTe (conhecimento de transporte eletronico) for cargo transport |\n| `get_cte` | Get CTe details and status by reference |\n| `cancel_cte` | Cancel an authorized CTe |\n| `create_mdfe` | Create and emit an MDFe (manifesto eletronico de documentos fiscais) for cargo transport manifest |\n| `close_mdfe` | Close/finalize an MDFe (encerramento) after trip completion |\n| `register_webhook` | Register a webhook trigger (gatilho) that notifies your URL when fiscal document events occur |\n| `list_webhooks` | List all registered webhooks (gatilhos) |\n| `delete_webhook` | Delete a registered webhook by ID |\n\n## Authentication\n\nFocus NFe uses Basic Auth with the API token as username and empty password.\n\n## Sandbox / Testing\n\nFocus NFe provides a homologation environment at `homologacao.focusnfe.com.br`. Set `FOCUS_NFE_SANDBOX=true` to use it.\n\n### Get your credentials\n\n1. Go to [Focus NFe](https://focusnfe.com.br)\n2. Create an account\n3. Get your API token from the dashboard\n4. Set the `FOCUS_NFE_TOKEN` environment variable\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `FOCUS_NFE_TOKEN` | Yes | API token from Focus NFe |\n| `FOCUS_NFE_SANDBOX` | No | Set to `\"true\"` for homologation mode |\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- `correction_letter` — Issue a correction letter for an NF-e\n- `manifest_recipient` — Manifest recipient awareness of an NF-e\n- `get_nfse_pdf` — Get PDF for a service invoice (NFS-e)\n\n### v0.3 (planned)\n- `batch_nfe` — Create multiple NF-e in a single request\n- `batch_nfse` — Create multiple NFS-e in a single request\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- [Focus NFe Website](https://focusnfe.com.br)\n- [Focus NFe API Documentation](https://focusnfe.com.br/doc)\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"}