Mcp Nfe Io

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for NFe.io — NF-e, NFS-e, CNPJ, CEP

VerifiedSTDIODesktop onlyWeb Search & Scraping Finance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-nfe-io
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-nfe-io.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-nfe-io?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server for NFe.io that lets an assistant issue, query, cancel and email Brazilian NF-e and NFS-e fiscal documents and look up CNPJ and CEP data.

What you can do: Issue, fetch, list, cancel and email NFS-e service invoices, and retrieve their PDF and XML links. Issue, fetch, list and cancel NF-e product invoices, retrieve DANFE PDF and XML links, and file correction letters for authorized invoices. Look up Brazilian company data by CNPJ and resolve CEP postal codes to addresses. List, fetch and provision companies on the NFe.io account. List, register and delete webhook endpoints for invoice event callbacks.
When to use it: Useful when an assistant needs to work with Brazilian fiscal documents through NFe.io: creating or cancelling invoices, checking invoice status, pulling PDFs and XML, or enriching records with CNPJ and CEP lookups.
Requirements: Runs locally via npx from the npm package, so Node.js is needed. Requires an NFe.io account and the NFEIO_API_KEY environment variable; NFEIO_COMPANY_ID is optional and sets a default company. Network access to NFe.io API hosts is required. A demo mode returns canned responses without network access.

Before you install

The API key grants invoice issuance and query access to the NFe.io account, so keep it out of shared configs. Tools create, cancel and email real fiscal documents, provision companies and register or delete webhooks, which changes account state and may have legal or financial consequences. Emailing an invoice sends the PDF to a recipient outside the session.

Installation

In SourceWeft

Open Mcp Nfe Io in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-nfe-io

MCP server for NFe.io — NF-e / NFS-e fiscal document emission plus CNPJ and CEP lookups for Brazil.

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

{  "mcpServers": {    "nfe-io": {      "command": "npx",      "args": ["-y", "@codespar/mcp-nfe-io"],      "env": {        "NFEIO_API_KEY": "your-api-key",        "NFEIO_COMPANY_ID": "your-company-id-or-cnpj"      }    }  }}

{  "mcpServers": {    "nfe-io": {      "command": "npx",      "args": ["-y", "@codespar/mcp-nfe-io"],      "env": {        "NFEIO_API_KEY": "your-api-key",        "NFEIO_COMPANY_ID": "your-company-id-or-cnpj"      }    }  }}

Claude Code

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json

{  "servers": {    "nfe-io": {      "command": "npx",      "args": ["-y", "@codespar/mcp-nfe-io"],      "env": {        "NFEIO_API_KEY": "your-api-key",        "NFEIO_COMPANY_ID": "your-company-id-or-cnpj"      }    }  }}

{  "servers": {    "nfe-io": {      "command": "npx",      "args": ["-y", "@codespar/mcp-nfe-io"],      "env": {        "NFEIO_API_KEY": "your-api-key",        "NFEIO_COMPANY_ID": "your-company-id-or-cnpj"      }    }  }}

Tools (22)

Tool	Purpose
`create_nfse`	Issue an NFS-e (service invoice).
`get_nfse`	Fetch a single NFS-e by id.
`cancel_nfse`	Cancel an NFS-e.
`list_nfse`	List NFS-e with pagination + optional flowStatus filter.
`email_nfse`	Email the PDF of an already-issued NFS-e to a recipient.
`create_nfe`	Issue an NF-e (product invoice).
`get_nfe`	Fetch a single NF-e by id.
`cancel_nfe`	Cancel an NF-e.
`list_nfe`	List NF-e with pagination + optional status filter.
`get_nfe_pdf`	Return the DANFE PDF URL for an issued NF-e.
`consult_cnpj`	Look up Brazilian company data (razão social, status, address) by CNPJ.
`consult_cep`	Resolve a Brazilian postal code (CEP) to a full address.
`correct_nfe`	Issue a Carta de Correção (CC-e) for an authorized NF-e.
`get_nfe_xml`	Return the authorized XML URL for an NF-e.
`get_nfse_pdf`	Return the PDF URL for an issued NFS-e.
`get_nfse_xml`	Return the XML URL for an issued NFS-e.
`list_companies`	List companies registered on the NFe.io account.
`get_company`	Fetch a single company by id or CNPJ.
`create_company`	Provision a new company on NFe.io.
`list_webhooks`	List webhook endpoints registered for a company (invoice event callbacks).
`create_webhook`	Register a webhook endpoint.
`delete_webhook`	Remove a webhook endpoint by id.

Environment

Variable	Required	Notes
`NFEIO_API_KEY`	yes	Issuance + query scopes. NFe.io supports splitting this into two keys; either is fine.
`NFEIO_COMPANY_ID`	no	Default company id (or CNPJ). Per-call `company_id` arguments override it.

Hosts

NFe.io segments its API across three hostnames. This server maps tools to the correct one automatically:

api.nfse.io — product invoices
api.nfe.io — service invoices + company management
nfe.api.nfe.io — lookups (CNPJ, CEP)

Demo mode

Pass --demo or set MCP_DEMO=true to return canned responses without hitting the network. Useful for documentation, screencasts, and CI.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

NFEIO_API_KEY (required, secret) — API key for NFe.io (issuance + query)
NFEIO_COMPANY_ID — Default company ID (CNPJ or NFe.io company UUID) to use when not provided per-call

Issue credentials at the provider's developer portal: https://nfe.io/docs.

License

MIT

Source: packages/fiscal/nfe-io/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts