Nfe BR MCP Server

by cmendezsio.github.cmendezs/mcp-nfe-brv0.9.1

MCP server for Brazilian e-invoicing: NF-e and NFC-e (modelo 55/65), schema 4.00, SEFAZ.

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active28d ago

Install Nfe BR MCP server

claude mcp add nfe-br -- uvx mcp-nfe-br

{
  "mcpServers": {
    "nfe-br": {
      "command": "uvx",
      "args": [
        "mcp-nfe-br"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "nfe-br": {
      "command": "uvx",
      "args": [
        "mcp-nfe-br"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "nfe-br": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-nfe-br"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "nfe-br": {
      "command": "uvx",
      "args": [
        "mcp-nfe-br"
      ]
    }
  }
}

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

Variable	Required	Secret	Description
BR_READ_ONLY	—	—	Master switch. Set to '1' to disable all write-side tools across NF-e, NFC-e, NFS-e, AND CT-e (br__submit_nfe, br__distribute_dfe, br__submit_nfse, br__cancel_nfse, br__submit_cte, br__cancel_cte, br__correct_cte). Read-only mode for safe exploration. Setting only this variable is sufficient to disable all CT-e writes too — BR_CTE_READ_ONLY is an additional, independent gate, not a required second step.
BR_CTE_READ_ONLY	—	—	Set to '1' to disable the three CT-e write-side tools (br__submit_cte, br__cancel_cte, br__correct_cte). Independent of BR_READ_ONLY — either variable being set to '1' is sufficient to block CT-e writes; use this one to gate CT-e alone while leaving NF-e/NFS-e writes enabled.
LOG_LEVEL	—	—	Logging level: DEBUG, INFO (default), WARNING, or ERROR

Active — last maintenance signal 28d ago. The newest of the signals below sets the band.

›How do I install the Nfe BR MCP server in Claude Code?

Run: claude mcp add nfe-br -- uvx mcp-nfe-br. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Nfe BR require an API key?

No required environment variables are declared in its published metadata.

›Can I use Nfe BR as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Nfe BR in the official MCP registry?

Yes, as io.github.cmendezs/mcp-nfe-br.