Advertise
MCP.so
Sign In

MCP NFSe Nacional

@SamuelMoraesF

Repository

Basic information

Category

Other

Transports

stdio

Author

SamuelMoraesF

Submitted by

Samuel Moraes

About MCP NFSe Nacional

🇧🇷 MCP Server para consultar NFSe no portal nacional (nfse.gov.br). Busque notas, baixe XMLs e PDFs direto do seu AI agent.

#brazil#gov-br#nfse#nfse-nacional#nfe

MCP NFSe Nacional config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nfse-nacional": {
      "command": "npx",
      "args": [
        "-y",
        "samuelmoraesf/mcp-nfse-nacional"
      ],
      "env": {
        "CERT_PASSWORD": "sua_senha_do_certificado",
        "CERT_FILE": "caminho/para/seu/certificado.pfx",
        "NODE_OPTIONS": "--openssl-legacy-provider"
      }
    }
  }
}

MCP NFSe Nacional tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MCP NFSe Nacional?

MCP NFSe Nacional is an MCP (Model Context Protocol) server that enables AI agents to authenticate with an e-CNPJ/e-CPF digital certificate and consult, retrieve details, and download PDFs of Brazilian Electronic Service Invoices (NFSe) from the national portal (nfse.gov.br).

How to use MCP NFSe Nacional?

Install and run via npx with the required environment variables CERT_FILE (path to .pfx/.p12 certificate) and CERT_PASSWORD. Optionally configure MCP_TRANSPORT (stdio or streamable-http) and STORAGE_PATH. The server exposes three tools: nfse_buscar, nfse_detalhes, and nfse_pdf. Docker images are also provided for the streamable-http mode.

Key features of MCP NFSe Nacional

  • Three tools: list invoices, get details, download PDFs.
  • Automatic authentication with digital certificate.
  • Transparent session renewal on authentication errors.
  • Supports stdio and streamable-http transport modes.
  • Docker image for production deployment.
  • Configurable local storage for downloaded XMLs and PDFs.

Use cases of MCP NFSe Nacional

  • AI agents retrieving NFSe data for a given date range.
  • Automating the download of DANFSe PDFs from the national portal.
  • Integrating invoice details into tax compliance workflows.
  • Providing LLM-based assistants with access to real fiscal documents.

Frequently asked questions

1

What authentication is required?

The server requires a digital certificate file (`.pfx` or `.p12`) and its password. Authentication is handled automatically; if the session expires, the server re-authenticates transparently.

2

What runtime or dependencies are needed?

The server is a Node.js application run via `npx`. No additional runtime dependencies beyond Node.js are required. For Docker, a pre-built image is available.

3

Where are downloaded files stored?

XMLs and PDFs are saved locally in the directory specified by `STORAGE_PATH` (defaults to `./storage`). The path can be customized via environment variable.

4

Which transport modes are supported?

Two modes: `stdio` (default, for direct client integration like Claude Desktop or VS Code) and `streamable-http` (for HTTP-based servers). In HTTP mode, bind address and port are configurable.

5

What security precautions should I take?

The certificate is a critical asset; never version it in Git, restrict file permissions, use environment variables for the password, and do not expose the HTTP server publicly without authentication. Mount the certificate as read-only in Docker.

Comments

More Other MCP servers

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

ICSS

chokcoco

不止于 CSS

20.7K
Advertise