Mcp Nuvem Fiscal
Let your agent issue and manage Brazilian electronic invoices (NF-e, NFS-e, NFC-e) and look up CNPJ and CEP through Nuvem Fiscal from the IDE.
Overview
io.github.codespar/mcp-nuvem-fiscal is a MCP server for the Operate phase that lets agents work with Nuvem Fiscal for NF-e, NFS-e, NFC-e, CNPJ, and CEP in Brazil.
What is this MCP server?
- stdio MCP @codespar/mcp-nuvem-fiscal v0.1.2
- Coverage for NF-e, NFS-e, and NFC-e Brazilian tax documents
- CNPJ and CEP lookup helpers for billing and onboarding forms
- Requires NUVEM_FISCAL_CLIENT_SECRET
- Hosted in mcp-dev-brasil fiscal/nuvem-fiscal package
- Package version 0.1.2
- Document types referenced: NF-e, NFS-e, NFC-e
- Lookup utilities: CNPJ, CEP
Community signal: 252 GitHub stars.
What problem does it solve?
Brazilian invoicing and tax IDs are painful to script manually while you are fixing billing bugs or onboarding customers.
Who is it for?
Indie SaaS and e-commerce sellers in Brazil already using Nuvem Fiscal who want agent help for invoices and registry lookups.
Skip if: Non-Brazilian businesses, teams without Nuvem Fiscal API access, or builders who only need generic PDF invoices with no SEFAZ integration.
What do I get? / Deliverables
Your agent gains MCP tools backed by Nuvem Fiscal after you set NUVEM_FISCAL_CLIENT_SECRET and register the stdio server.
- MCP tools for Nuvem Fiscal document and lookup operations
- Agent-ready fiscal workflow without custom REST scaffolding
- Configured secret-based auth for the fiscal API
Recommended MCP Servers
Journey fit
Fiscal document flows are ongoing compliance work after you ship, so Operate is the canonical shelf even though you wire the MCP during build. Iterate fits recurring invoice fixes, certificate updates, and tax workflow tweaks agents help you run in production.
How it compares
Nuvem Fiscal MCP connector, not a standalone tax advisory skill.
Common Questions / FAQ
Who is mcp-nuvem-fiscal for?
Solo builders and small shops selling in Brazil who run Nuvem Fiscal and want Claude Code or Cursor to help with electronic invoices and CNPJ or CEP validation.
When should I use mcp-nuvem-fiscal?
Use it in Operate when you iterate on billing, fix invoice failures, or automate fiscal lookups during customer support and back-office tasks.
How do I add mcp-nuvem-fiscal to my agent?
Add @codespar/mcp-nuvem-fiscal as a stdio MCP server, export NUVEM_FISCAL_CLIENT_SECRET, and restart your agent so tools load from the npm package.