Skip to main content
Glama

Server Details

Brazilian SEFAZ e-invoices (NF-e, CT-e) issued against your company. A1 cert, DANFE PDF.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
95.7% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
mcp-dir/dfe-mcp
GitHub Stars
0
Server Listing
DF-e
ChatGPT
–
Claude
–

TDQS

A3.6/5.0

Scored across 12 tools

Disambiguation3/5

The six dfe_* tools are clearly distinguished by key/NSU/sync/quota/account/DANFE, but the platform layer has overlap: connect and toolkit_info both report connection/status, and marketplace contains a report_bug action that duplicates the standalone report_bug tool. The detailed descriptions help, but an agent can still misselect between these near-duplicate entry points.

Naming Consistency3/5

The dfe_ prefix gives the fiscal tools a recognizable family, but the set mixes Portuguese and English (dfe_consultar_chave vs dfe_list_accounts) and mixes prefixed domain verbs with bare English platform verbs (authenticate, connect, show_version). It is readable and mostly snake_case, but not one consistent convention.

Tool Count4/5

Twelve tools is a reasonable, manageable count. The slight over-inclusion comes from six generic platform/meta tools (marketplace, authenticate, toolkit_info, report_bug, etc.) that sit alongside the DF-e domain tools, making the surface broader than the server name implies.

Completeness3/5

The receipt-side DF-e workflow is mostly covered: sync, lookup by chave/NSU, quota check, account listing, and DANFE generation all exist. However, there is no manifestation/event tool (ciência, confirmação, desconhecimento), so resumo documents cannot be upgraded to complete XML/DANFE within this server, and the sync description references an auditor_fiscal_auditar_nota tool that is not present.

Available Tools

12 tools
authenticateA
Idempotent
Inspect

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header Authorization: Bearer <token> for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "" } after the user pastes, or with no args to get the link.

Inputs: token.

connectA
Read-onlyIdempotent
Inspect

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Inputs: no named parameters.

dfe_consultar_chaveA
Read-onlyIdempotent
Inspect

Busca um documento pela chave de acesso de 44 dígitos. LIMITES: só documentos que chegaram ao Ambiente Nacional nos ÚLTIMOS 90 DIAS, e nunca a nota em que este CNPJ é o EMITENTE (a SEFAZ não devolve a própria emissão).

Inputs: chave (required), account.

dfe_consultar_nsuA
Read-onlyIdempotent
Inspect

Busca UM documento específico pelo NSU. Serve para recuperar um item que falhou na descompactação durante a sincronização — não para varrer a fila (isso é dfe_sincronizar).

Inputs: nsu (required), account.

dfe_gerar_danfeA
Read-onlyIdempotent
Inspect

Gera o DANFE (o PDF da nota) a partir do XML. A SEFAZ distribui XML, não PDF, então esta é a representação gráfica para imprimir, anexar ou mandar pro cliente. COMO USAR: passe em xml o conteúdo do documento que veio em dfe_sincronizar (campo documentos[].xml). Assim NÃO gasta consulta na SEFAZ. Se não tiver o XML em mãos, use chave ou nsu — mas aí gasta uma das consultas da hora. SÓ FUNCIONA com documento completo: true. Documento resumo não tem os itens, e sem itens não existe DANFE: o XML completo só sai depois da manifestação do destinatário. A resposta traz um link de download em files[], entregue ele ao usuário. Não tente ler o conteúdo do arquivo, é binário.

Inputs: nsu, xml, chave, account.

dfe_list_accountsB
Read-onlyIdempotent
Inspect

Lista os CNPJs conectados neste install (razão social, CNPJ e UF).

Inputs: account.

dfe_orcamentoA
Read-onlyIdempotent
Inspect

Quantas consultas ainda cabem nesta hora para este CNPJ, e se ele está bloqueado. Não consome consulta. Chame isto antes de uma carga grande — o limite da SEFAZ é por CNPJ e conta também o que outros sistemas do cliente consultarem.

Inputs: account.

dfe_sincronizarA
Read-onlyIdempotent
Inspect

Puxa os documentos fiscais NOVOS emitidos contra este CNPJ (nota de fornecedor, evento, CT-e) — NFeDistribuicaoDFe. COMO USAR: chame com ult_nsu: "0" na primeira vez. A resposta traz proximo_nsu — passe ELE na chamada seguinte, sem alterar. Repita até fim_da_fila: true. PARE quando fim_da_fila for true. Continuar consultando depois disso é o que a SEFAZ pune com bloqueio de 1 hora no CNPJ. Cada documento vem com completo: true = XML íntegro da nota (dá para auditar em auditor_fiscal_auditar_nota); false = apenas RESUMO (chave, emitente, valor), que é o que a SEFAZ entrega enquanto o destinatário não fizer a manifestação. ATENÇÃO: este serviço NÃO devolve as notas que VOCÊ emitiu — só as recebidas. Para auditar a própria emissão, pegue o XML no seu ERP (ex.: omie_get_invoice_xml).

Inputs: account, ult_nsu, forcar_nsu.

marketplaceAInspect

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/ link that opens without login.

Inputs: limit, query, action, mcp_id, +19 more.

report_bugA
Idempotent
Inspect

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Inputs: message (required), context, conversation.

show_versionA
Read-onlyIdempotent
Inspect

Show the current MCP platform and adapter versions.

Inputs: no named parameters.

toolkit_infoA
Read-onlyIdempotent
Inspect

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server to query details of received electronic service invoices (NFS-e) from the Brazilian Federal Revenue. Read-only, no credentials required, pay-per-use with prepaid credits.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Queries official Brazilian federal received electronic invoices (NFS-e) via a hosted, read-only MCP server with prepaid credits, requiring no platform credentials.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.