Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.codespar/mcp-focus-nfe

NPM · @CODESPAR/MCP-FOCUS-NFE · SCANNED AUG 4

MCP server for Focus NFe — NFe, NFSe, NFCe emission and management

+44 this week 69 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability71
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 1403 tokens (~73/item across 19 items; 19 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
  • Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @codespar/mcp-focus-nfe

# add to Claude Code
claude mcp add codespar-mcp-focus-nfe -- npx -y @codespar/mcp-focus-nfe
# add to Codex CLI
codex mcp add codespar-mcp-focus-nfe -- npx -y @codespar/mcp-focus-nfe
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codespar-mcp-focus-nfe": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@codespar/mcp-focus-nfe"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add codespar-mcp-focus-nfe --command npx --arg -y --arg @codespar/mcp-focus-nfe
# ~/.hermes/config.yaml
mcp_servers:
  codespar-mcp-focus-nfe:
    command: "npx"
    args: ["-y", "@codespar/mcp-focus-nfe"]
// mcp.json
{
  "mcpServers": {
    "codespar-mcp-focus-nfe": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-focus-nfe"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 4 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

  • 3 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

  • 2 Aug 26 +47
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Schema quality: unverified → good functional
    • Stability: unverified → 0.23 functional
    • MCP protocol: unverified → pass functional
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • Tool coverage: unverified → 100 functional
    • Licence: MIT functional
  • 1 Aug 26 +15
    • Malware scan: unverified → pass security
  • 31 Jul 26 −10
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −53
    • Malware scan: pass → unverified security
    • Known CVEs: partial → unverified security
    • Tool coverage: 100 → unverified functional
    • Dependency health: partial → unverified functional
  • 29 Jul 26 +43
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Tool coverage: unverified → 100 functional
    • Maintenance: unverified → pass functional
    • License: unverified → pass functional
    • Licence: MIT functional
  • 28 Jul 26 −21
    • Tool coverage: 100 → unverified functional
    • Dependency health: unverified → partial functional
    • First check of Schema quality: unverified functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@codespar/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 19 exposed · ~1,336 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
cancel_cte ~41

Cancel an authorized CTe

NameTypeReqDescription
justificativastringyesCancellation reason (15-255 chars)
refstringyesCTe reference ID

No output schema declared.

No examples provided.

cancel_nfce ~41

Cancel an authorized NFCe

NameTypeReqDescription
justificativastringyesCancellation reason (15-255 chars)
refstringyesNFCe reference ID

No output schema declared.

No examples provided.

cancel_nfe ~48

Cancel an authorized NFe (within 24h of emission)

NameTypeReqDescription
justificativastringyesCancellation reason (15-255 chars)
refstringyesNFe reference ID

No output schema declared.

No examples provided.

cancel_nfse ~36

Cancel an authorized NFSe

NameTypeReqDescription
justificativastringyesCancellation reason
refstringyesNFSe reference ID

No output schema declared.

No examples provided.

close_mdfe ~71

Close/finalize an MDFe (encerramento) after trip completion

NameTypeReqDescription
codigo_municipio_encerramentostringIBGE municipality code for closing
refstringyesMDFe reference ID
uf_encerramentostringState of closing (2 letters)

No output schema declared.

No examples provided.

create_cte ~232

Create and emit a CTe (conhecimento de transporte eletronico) for cargo transport

NameTypeReqDescription
cnpj_emitentestringyesTransport carrier CNPJ
destinatarioobjectRecipient info (cnpj/cpf, razao_social, endereco)
modalstringyesTransport modal (01=Rodoviario, 02=Aereo, 03=Aquaviario, 04=Ferroviario, 05=Dutoviario, 06=Multimodal)
natureza_operacaostringOperation nature (e.g. 'Prestacao de servico de transporte')
refstringyesUnique reference ID for this CTe
remetenteobjectSender info (cnpj/cpf, razao_social, endereco)
tipo_serviconumberService type (0=Normal, 1=Subcontratacao, 2=Redespacho, 3=Redespacho Intermediario, 4=Servico Vinculado Multimodal)
valor_totalnumberTotal transport service value

No output schema declared.

No examples provided.

create_mdfe ~177

Create and emit an MDFe (manifesto eletronico de documentos fiscais) for cargo transport manifest

NameTypeReqDescription
cnpj_emitentestringyesEmitter CNPJ
documentos_fiscais_vinculadosarrayLinked fiscal documents (NFe/CTe chaves) grouped per municipio de descarga
modalstringyesTransport modal (1=Rodoviario, 2=Aereo, 3=Aquaviario, 4=Ferroviario)
refstringyesUnique reference ID for this MDFe
rodoviarioobjectRoad transport info: placa, renavam, ciot, condutores
uf_fimstringyesState of unloading end (2 letters)
uf_iniciostringyesState of loading start (2 letters)

No output schema declared.

No examples provided.

create_nfce ~91

Create and emit an NFCe (nota fiscal do consumidor eletronica)

NameTypeReqDescription
cnpj_emitentestringyesEmitter CNPJ
forma_pagamentoarrayPayment methods
itemsarrayyesNFCe items (same structure as NFe items)
natureza_operacaostringyesOperation nature
refstringyesUnique reference ID for this NFCe

No output schema declared.

No examples provided.

create_nfe ~150

Create and emit an NFe (nota fiscal eletronica)

NameTypeReqDescription
cnpj_destinatariostringRecipient CNPJ
cnpj_emitentestringyesEmitter CNPJ
cpf_destinatariostringRecipient CPF
forma_pagamentostringPayment form code
itemsarrayyesNFe items
natureza_operacaostringyesOperation nature (e.g. 'Venda de mercadoria')
nome_destinatariostringRecipient name
refstringyesUnique reference ID for this NFe
tipo_documentonumberyesDocument type (0=entrada, 1=saida)

No output schema declared.

No examples provided.

create_nfse ~97

Create and emit an NFSe (nota fiscal de servico)

NameTypeReqDescription
cnpjstringyesCNPJ of emitter
inscricao_municipalstringMunicipal registration
razao_socialstringCompany name
refstringyesUnique reference ID for this NFSe
servicoobjectyesService details
tomadorobjectService taker (client) info

No output schema declared.

No examples provided.

delete_webhook ~30

Delete a registered webhook by ID

NameTypeReqDescription
idstringyesWebhook (gatilho) ID

No output schema declared.

No examples provided.

get_cte ~29

Get CTe details and status by reference

NameTypeReqDescription
refstringyesCTe reference ID

No output schema declared.

No examples provided.

get_nfce ~29

Get NFCe details and status by reference

NameTypeReqDescription
refstringyesNFCe reference ID

No output schema declared.

No examples provided.

get_nfe ~47

Get NFe details and status by reference

NameTypeReqDescription
completanumberSet to 1 for full detail (default 0)
refstringyesNFe reference ID

No output schema declared.

No examples provided.

get_nfe_pdf ~33

Get NFe PDF (DANFE) download URL

NameTypeReqDescription
refstringyesNFe reference ID

No output schema declared.

No examples provided.

get_nfse ~29

Get NFSe details and status by reference

NameTypeReqDescription
refstringyesNFSe reference ID

No output schema declared.

No examples provided.

list_webhooks ~19

List all registered webhooks (gatilhos)

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

register_webhook ~66

Register a webhook trigger (gatilho) that notifies your URL when fiscal document events occur

NameTypeReqDescription
cnpjstringCNPJ to filter events (optional, omit for all CNPJs on the token)
urlstringyesHTTPS URL to receive event notifications

No output schema declared.

No examples provided.

send_correction_letter ~70

Send a correction letter (Carta de Correcao / CCe) for an authorized NFe

NameTypeReqDescription
correcaostringyesCorrection text (15-1000 chars, cannot change tax values, parties, dates, or quantities)
refstringyesNFe reference ID

No output schema declared.

No examples provided.