Skip to content
MCP server

MCP Nfse Nacional

MCP Server para consulta de NFSe no portal nacional (nfse.gov.br)

Install
Pricing
Open source
Runs
Locally or Remotely
Version
1.0.3
Listing updated
4 days ago

About MCP Nfse Nacional

MCP Nfse Nacional is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add mcp-nfse-nacional --env CERT_PASSWORD='<CERT_PASSWORD>' --env CERT_FILE='<CERT_FILE>' -- npx -y mcp-nfse-nacional

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-nfse-nacional": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-nfse-nacional"
      ],
      "env": {
        "CERT_PASSWORD": "<CERT_PASSWORD>",
        "CERT_FILE": "<CERT_FILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-nfse-nacional": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-nfse-nacional"
      ],
      "env": {
        "CERT_PASSWORD": "<CERT_PASSWORD>",
        "CERT_FILE": "<CERT_FILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-nfse-nacional": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-nfse-nacional"
      ],
      "env": {
        "CERT_PASSWORD": "<CERT_PASSWORD>",
        "CERT_FILE": "<CERT_FILE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-nfse-nacional": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-nfse-nacional"
      ],
      "env": {
        "CERT_PASSWORD": "<CERT_PASSWORD>",
        "CERT_FILE": "<CERT_FILE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-nfse-nacional": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-nfse-nacional"
      ],
      "env": {
        "CERT_PASSWORD": "<CERT_PASSWORD>",
        "CERT_FILE": "<CERT_FILE>"
      }
    }
  }
}

Configuration

  • CERT_PASSWORDSenha do certificado digital (e-CNPJ/e-CPF) em formato PFXRequired
  • CERT_FILECaminho para o arquivo do certificado digital (.pfx)Required
  • NODE_OPTIONSOpções do Node.js (use --openssl-legacy-provider para compatibilidade com certificados)
  • CERT_PASSWORDSenha do certificado digital (e-CNPJ/e-CPF) em formato PFXRequired
  • CERT_FILECaminho para o arquivo do certificado digital (.pfx)Required
  • MCP_PORTPorta do servidor HTTP
  • STORAGE_PATHDiretório onde os XMLs e PDFs baixados serão armazenados

Pricing

Open source

MCP Nfse Nacional FAQ

Is MCP Nfse Nacional free?

Yes. MCP Nfse Nacional is open source, so you can use and self-host it for free.

How do I add MCP Nfse Nacional to Claude Code?

Run this command in your terminal: claude mcp add mcp-nfse-nacional --env CERT_PASSWORD='<CERT_PASSWORD>' --env CERT_FILE='<CERT_FILE>' -- npx -y mcp-nfse-nacional