Nuvem Fiscal MCP Server

Nuvem Fiscal uses OAuth2 client credentials. Its 24 documented tools cover nfe, cte, mdfe, nfse.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Nuvem Fiscal

before you install - you'll need

Set NUVEM_FISCAL_CLIENT_ID, NUVEM_FISCAL_CLIENT_SECRET before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-fiscal-n -- npx -y @codespar/mcp-nuvem-fiscal

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-fiscal-n": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-nuvem-fiscal"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-nuvem-fiscal - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Nuvem Fiscal can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a NF-e (nota fiscal eletrônica), cancel a NF-e, create a NFS-e (nota fiscal de serviço eletrônica), and cancel a NFS-e.

Capability map

Tools grouped from the project's README - what Nuvem Fiscal lets an agent do.

Nfe

6 tools - e.g. Create a NF-e (nota fiscal eletrônica); Get NF-e details by ID; Cancel a NF-e

create_nfe · get_nfe · cancel_nfe · get_nfe_events · send_correction_letter_nfe · get_nfe_batch

Cte

4 tools - e.g. Create a CT-e (conhecimento de transporte eletrônico); Get CT-e details by ID; Cancel a CT-e

create_cte · get_cte · cancel_cte · send_correction_letter_cte

Mdfe

4 tools - e.g. Create a MDF-e (manifesto de documentos fiscais eletrônico); Get MDF-e details by ID; Cancel a MDF-e (manifesto)

create_mdfe · get_mdfe · cancel_mdfe · close_mdfe

Nfse

3 tools - e.g. Create a NFS-e (nota fiscal de serviço eletrônica); Get NFS-e details by ID; Cancel a NFS-e

create_nfse · get_nfse · cancel_nfse

Nfce

2 tools - e.g. Create a NFC-e (nota fiscal de consumidor eletrônica); Cancel a NFC-e (nota fiscal de consumidor eletrônica)

create_nfce · cancel_nfce

Consult

2 tools - e.g. Consult company data by CNPJ number; Consult address by CEP (postal code)

consult_cnpj · consult_cep

Register

1 tool - e.g. Register a company in Nuvem Fiscal

register_company

read & search

1 tool - e.g. List all companies (empresas) registered in the account.

list_empresas

04 · Who maintains Nuvem Fiscal

mcp-nuvem-fiscal is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

  1. mcp-asaas MCP server for Asaas - billing automation, Pix, boleto, credit card, subscriptions ★ 269
  2. mcp-omie MCP server for Omie - ERP, customers, products, orders, invoices, financials ★ 269
  3. mcp-sendgrid MCP server for SendGrid - global transactional + marketing email (Twilio-owned) ★ 269
  4. mcp-evolution-api MCP server for Evolution API - WhatsApp messaging, instances, contacts ★ 269
  5. mcp-stripe-acp Stripe ACP - AI agent checkout, payment delegation, products, invoices ★ 269
  6. mcp-mercado-bitcoin MCP server for Mercado Bitcoin - Brazilian crypto exchange, trading, orderbook, withdrawals ★ 269

05 · Facts

category
other - actively maintained as of 2026-08-25.
registry
io.github.codespar/mcp-nuvem-fiscal (active, first published 2026-04-12 · 3 versions)
packages
npm:@codespar/mcp-nuvem-fiscal

06 · Nuvem Fiscal FAQ

Is Nuvem Fiscal still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Nuvem Fiscal do?

With this server connected, an agent can create a NF-e (nota fiscal eletrônica), cancel a NF-e, create a NFS-e (nota fiscal de serviço eletrônica), and cancel a NFS-e.

How do I install Nuvem Fiscal?

Run `npx -y @codespar/mcp-nuvem-fiscal`. The README documents 2 environment variables (NUVEM_FISCAL_CLIENT_ID, NUVEM_FISCAL_CLIENT_SECRET) to set first. Set NUVEM_FISCAL_CLIENT_ID, NUVEM_FISCAL_CLIENT_SECRET before connecting. You can also paste the ready-made client config above.

Does Nuvem Fiscal run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Nuvem Fiscal

More MCP servers to compare · Clearsale · Konduto · Legiti · Sift · Bigdatacorp