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 (19)

Tool	Purpose
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 (within 24h of emission)
get_nfe_pdf	Get NFe PDF (DANFE) download URL
send_correction_letter	Send a correction letter (Carta de Correcao / CCe) for 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
create_nfce	Create and emit an NFCe (nota fiscal do consumidor eletronica)
get_nfce	Get NFCe details and status by reference
cancel_nfce	Cancel an authorized NFCe
create_cte	Create and emit a CTe (conhecimento de transporte eletronico) for cargo transport
get_cte	Get CTe details and status by reference
cancel_cte	Cancel an authorized CTe
create_mdfe	Create and emit an MDFe (manifesto eletronico de documentos fiscais) for cargo transport manifest
close_mdfe	Close/finalize an MDFe (encerramento) after trip completion
register_webhook	Register a webhook trigger (gatilho) that notifies your URL when fiscal document events occur
list_webhooks	List all registered webhooks (gatilhos)
delete_webhook	Delete a registered webhook by ID

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

1. Go to Focus NFe
2. Create an account
3. Get your API token from the dashboard
4. 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 LATAM
• 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