MCP.Market

Nfe Io MCP server

by codespar·io.github.codespar/mcp-nfe-io·v0.2.2·271 stars
No reviews yet

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

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

271 stars

Reviews

Write one

Nobody has reviewed Nfe Io yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Nfe Io tools (22, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cancel_nfewrite action

    Cancel an NF-e. Must include a justification of at least 15 characters.

  • cancel_nfsewrite action

    Cancel an NFS-e. Some municipalities only allow cancellation within a short window (commonly 30 days).

  • consult_cep

    Resolve a Brazilian postal code (CEP) to a full address.

  • consult_cnpj

    Look up Brazilian company data (razão social, status, address) by CNPJ.

  • correct_nfe

    Issue a Carta de Correção (CC-e) for an authorized NF-e. Use for minor fixes that don't change value, parties, dates, or tax data.

  • create_companywrite action

    Provision a new company on NFe.io. Requires federalTaxNumber (CNPJ), name, address, and fiscal certificates/config as enabled on the account.

  • create_nfewrite action

    Issue an NF-e (product invoice). Returns the invoice with status, access key (chave), and DANFE URL once authorized.

  • create_nfsewrite action

    Issue an NFS-e (service invoice). Returns the invoice with flowStatus, rpsNumber, and PDF URL once processed.

  • create_webhookwrite action

    Register a webhook endpoint. NFe.io POSTs JSON payloads to `url` when the subscribed events fire.

  • delete_webhookwrite action

    Remove a webhook endpoint by id.

  • email_nfsewrite action

    Email the PDF of an already-issued NFS-e to a recipient.

  • get_company

    Fetch a single company by id or CNPJ.

  • get_nfe

    Fetch a single NF-e by id.

  • get_nfe_pdf

    Return the DANFE PDF URL for an issued NF-e. PDFs are generated asynchronously; call again if not ready.

  • get_nfe_xml

    Return the authorized XML URL for an NF-e. Requires the invoice to be in status Authorized.

  • get_nfse

    Fetch a single NFS-e by id.

  • 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.

  • list_nfe

    List NF-e with pagination + optional status filter.

  • list_nfse

    List NFS-e with pagination + optional flowStatus filter.

  • list_webhooks

    List webhook endpoints registered for a company (invoice event callbacks).

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 29 days ago15/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Nfe Io compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 63% of 48,255 servers
Tools
22
the typical server has 7
Tools that change things
36%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
271
more than 95% of 28,688 servers

What its tools let an agent do: 14 read · 4 create · 3 delete · 1 send or post

Install Nfe Io in Claude Code, Cursor or VS Code

Runs npx -y @codespar/mcp-nfe-io on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-nfe-io -- npx -y @codespar/mcp-nfe-io
Add to Cursor

What the publisher says

From the Nfe Io repository's README, as published. We do not edit it. Read it on GitHub

MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.

Agentic Payment Protocols

Four servers for the emerging agentic payment stack:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Nfe Io: common questions

Is Nfe Io MCP server safe?
Mostly: it is graded B (82/100). Read the Nfe Io safety report
How do I install Nfe Io?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Nfe Io need an API key?
Yes. The registry entry asks for NFEIO_API_KEY.
Is Nfe Io maintained?
The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.
How does Nfe Io compare with other MCP servers?
safety score 82/100 (higher than 63% of 48,255 servers); tools 22 (the typical server has 7); tools that change things 36% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from codespar →