Skip to main content
NU

Nuvem Fiscal

v20260413_01API Key

Issuance of NF-e, NFS-e, NFC-e, and CT-e. SEFAZ queries, invalidation, and cancellation across all 27 Brazilian states.

28 tools0 triggers🇧🇷 Brazillive in production

Install

terminal
$ npm install @codespar/mcp-nuvem-fiscal

Quickstart

quickstart.ts
// your agent can now call any Nuvem Fiscal tool via MCP
import { CodeSpar } from "@codespar/sdk";

const cs = new CodeSpar();
const session = await cs.create("user_123");
const tools = await session.tools("@codespar/mcp-nuvem-fiscal");

Why this toolkit

Built for production AI commerce workflows

→ MANAGED AUTH

OAuth2 without the pain

We handle token refresh, rotation, and multi-tenant credential storage. Your agent never touches raw secrets.

→ LLM-FRIENDLY

Optimized schemas

Every tool has a JSON Schema tuned for LLM function-calling. Fewer hallucinations, fewer retries.

→ SLA 99.9%

Running in production

Managed hosting with auto-scaling, circuit breakers, and retry logic. Battle-tested in real commerce loops.

Available tools · 28

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEnuvemfiscal_emitir_nfe
Issue a new Nota Fiscal Eletrônica
→
WRITEnuvemfiscal_emitir_nfse
Issue a Nota Fiscal de Serviço
→
DELETEnuvemfiscal_cancelar_nfe
Cancel an issued NF-e
→
READnuvemfiscal_consultar_sefaz
Check NF-e status on SEFAZ
→
READnuvemfiscal_download_danfe
Download the DANFE PDF
→

Compatible frameworks

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Usage patterns

Pattern #1

Autonomous collections

Agent monitors overdue invoices, sends WhatsApp reminders via send_message, generates Pix charges with create_pix_charge, and reconciles payments -- fully autonomous.

Pattern #2

Overnight fiscal reconciliation

Scheduled agent cross-references ERP orders with NF-e emissions using list_receivables, flags mismatches, and auto-corrects when confidence is high.

Frequently asked questions

All credentials are encrypted at rest with AES-256 and stored in an isolated vault per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets -- it receives scoped, short-lived session tokens.
CodeSpar — Commerce Infrastructure for AI Agents