@codespar/mcp-focus-nfe

@codespar/mcp-focus-nfe

MCP server for Focus NFe — NFe, NFSe, and NFCe fiscal document emission

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "focus-nfe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-focus-nfe"],
      "env": {
        "FOCUS_NFE_TOKEN": "your-token",
        "FOCUS_NFE_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add focus-nfe -- npx @codespar/mcp-focus-nfe

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "focus-nfe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-focus-nfe"],
      "env": {
        "FOCUS_NFE_TOKEN": "your-token",
        "FOCUS_NFE_SANDBOX": "true"
      }
    }
  }
}

Tools

Tool	Description
create_nfe	Create and emit an NFe (nota fiscal eletronica)
get_nfe	Get NFe details and status by reference
cancel_nfe	Cancel an authorized NFe
create_nfse	Create and emit an NFSe (nota fiscal de servico)
get_nfse	Get NFSe details and status by reference
cancel_nfse	Cancel an authorized NFSe
get_nfe_pdf	Get NFe PDF (DANFE) download URL
create_nfce	Create and emit an NFCe (nota fiscal do consumidor eletronica)

Authentication

Focus NFe uses Basic Auth with the API token as username and empty password.

Sandbox / Testing

Focus NFe provides a homologation environment at homologacao.focusnfe.com.br. Set FOCUS_NFE_SANDBOX=true to use it.

Get your credentials

• Go to Focus NFe
• Create an account
• Get your API token from the dashboard
• Set the FOCUS_NFE_TOKEN environment variable

Environment Variables

Variable	Required	Description
FOCUS_NFE_TOKEN	Yes	API token from Focus NFe
FOCUS_NFE_SANDBOX	No	Set to "true" for homologation mode

Roadmap

v0.2 (planned)

• create_cte — Create a CT-e (electronic transport document)
• get_cte — Get CT-e details by ID
• correction_letter — Issue a correction letter for an NF-e
• manifest_recipient — Manifest recipient awareness of an NF-e
• get_nfse_pdf — Get PDF for a service invoice (NFS-e)

v0.3 (planned)

• batch_nfe — Create multiple NF-e in a single request
• batch_nfse — Create multiple NFS-e in a single request

Want to contribute? Open a PR or request a tool.

Links

• Focus NFe Website
• Focus NFe API Documentation
• MCP Dev Brasil
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT