io.github.cmendezs/mcp-nfe-br MCP Server

io.github.cmendezs/mcp-nfe-br

Repository Registry

What is the io.github.cmendezs/mcp-nfe-br MCP server?

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

How to install io.github.cmendezs/mcp-nfe-br

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-nfe-br": {
      "command": "uvx",
      "args": [
        "mcp-nfe-br"
      ],
      "env": {
        "BR_READ_ONLY": "<YOUR_BR_READ_ONLY>",
        "BR_CTE_READ_ONLY": "<YOUR_BR_CTE_READ_ONLY>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}