Mcp Nfse Nacional
Query NFSe records on nfse.gov.br from your agent when you automate Brazilian service-invoice compliance for your PJ workflow.
Overview
mcp-nfse-nacional is a MCP server for the Build phase that consults NFSe on nfse.gov.br using a Brazilian digital certificate.
What is this MCP server?
- Consulta NFSe on the national portal nfse.gov.br via MCP tools
- npm mcp-nfse-nacional v1.0.3 plus Docker image docker.io/samuelmoraesf/mcp-nfse-nacional:1.0.3
- Requires PFX digital certificate via CERT_FILE and CERT_PASSWORD
- Supports streamable-http transport on localhost with MCP_PORT for Docker deployments
- Default NODE_OPTIONS --openssl-legacy-provider for legacy OpenSSL certificate compatibility
- Server version 1.0.3
- 2 distribution options: npm mcp-nfse-nacional and OCI docker.io/samuelmoraesf/mcp-nfse-nacional:1.0.3
- 2 required secrets or paths: CERT_FILE and CERT_PASSWORD
Community signal: 14 GitHub stars.
What problem does it solve?
Manually logging into nfse.gov.br to verify service invoices breaks automation when you are building finance tooling with an AI agent.
Who is it for?
Brazilian indie SaaS and PJ operators who already use e-CNPJ certificates and want NFSe nacional queries inside Claude Code or Cursor.
Skip if: Builders without Brazilian digital certificates, or teams that only need generic PDF invoice parsing unrelated to nfse.gov.br.
What do I get? / Deliverables
After certificate setup, your agent can trigger NFSe consult actions through MCP instead of one-off browser sessions.
- MCP-accessible NFSe consult tools against the national portal
- Stdio or streamable-http deployment paths (npm v1.0.3 or Docker 1.0.3)
- Agent-ready finance compliance helper for Brazilian service invoices
Recommended MCP Servers
Journey fit
National NFSe portal access is built during integration work linking your app or ops scripts to government tax infrastructure. Integrations is the canonical home for digital-certificate-authenticated MCP bridges to nfse.gov.br consult APIs.
How it compares
NFSe nacional certificate MCP gateway, not a full ERP or municipal NFS-e issuer skill.
Common Questions / FAQ
Who is mcp-nfse-nacional for?
It is for developers and founders in Brazil who need programmatic NFSe consultas on the national portal and want those calls available as MCP tools.
When should I use mcp-nfse-nacional?
Use it while building finance integrations, support bots, or internal ops tools that must verify NFSe status against nfse.gov.br during PJ workflows.
How do I add mcp-nfse-nacional to my agent?
Install mcp-nfse-nacional from npm for stdio, or run docker.io/samuelmoraesf/mcp-nfse-nacional:1.0.3 with CERT_FILE, CERT_PASSWORD, and MCP_PORT for HTTP MCP, then register the server in your client.