MCP.Market

DF-e MCP server

online · 100% uptime
by mcp-dir·io.github.mcp-dir/dfe-mcp·v0.1.0

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

A88/100grade A
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody has reviewed DF-e yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

DF-e tools (12)

write = sends, deletes, buys or posts
  • authenticateFree

    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: "<jwt>" } after the user pastes, or with no args to get the link.

  • connectFree

    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.

  • dfe_consultar_chaveFree

    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).

  • dfe_consultar_nsuFree

    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).

  • dfe_gerar_danfeFree

    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.

  • dfe_list_accountsFree

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

  • dfe_orcamentoFree

    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.

  • dfe_sincronizarFree

    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).

  • marketplaceFree

    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/<slug> link that opens without login.

  • report_bugFree

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

  • show_versionFree

    Show the current MCP platform and adapter versions.

  • toolkit_infoFree

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

Public scan report

scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 898ms20/20
  • Tool poisoning12 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 60 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How DF-e compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,243 servers
Tools
12
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote server answers 100%
Response time
115 ms
faster than 81% of 30,027 servers

What its tools let an agent do: 11 read · 1 change

Install DF-e in Claude Code, Cursor or VS Code

claude mcp add --transport http dfe-mcp https://api.mcp.ai/p_dfe
Add to Cursor

What the publisher says

From the DF-e repository's README, as published. We do not edit it. Read it on GitHub

DF-e

DF-e MCP, the invoices your suppliers issued against your Brazilian company

Pulls the electronic fiscal documents issued against your Brazilian company (supplier invoices, CT-e freight bills and events) straight from SEFAZ, through the official NFeDistribuicaoDFe web service, using your own A1 digital certificate. Incremental NSU sync with query-budget control so your tax ID never gets blocked. It also renders the DANFE PDF from the XML, which is the printable document, since SEFAZ distributes XML and not PDF. Read-only. Not affiliated with SEFAZ or the Brazilian Federal Revenue Service.

  • 📥 The invoices that came IN, not the ones you issued — everything suppliers and carriers issued against your tax ID, straight from SEFAZ
  • 🔐 Your own A1 certificate, no middleman — the SEFAZ handshake uses your company's own e-CNPJ, encrypted at rest
  • 🔁 Incremental NSU sync — each call brings up to 50 documents and the next one resumes where it stopped, until the queue ends
  • 🚦 It will not get your tax ID blocked — SEFAZ enforces a 1-hour block on whoever keeps polling past the end of the queue, and one tool just reports the hour's remaining budget
  • 🧾 DANFE PDF from the XML — the printable representation SEFAZ does not distribute, rendered without spending a query
  • 💬 Works with any MCP client: Claude Desktop, ChatGPT, Cursor, VS Code, Cline, Continue

Versão em português · Full docs (PT-BR) · Agent skill

One-click install

Claude (Web and Desktop)

Anthropic unified MCP installation at claude.ai/customize/connectors. The same link works for Claude Web and Claude Desktop (just be logged in):

➕ Open in Claude and connect

Manual (if the deeplink does not open): claude.ai/customize/connectors → + → Add custom connector → paste Name DF-e and URL https://api.mcp.ai/p_dfe.

Cursor

➕ Install DF-e in Cursor

VS Code (Copilot Chat)

➕ Install DF-e in VS Code

ChatGPT, Manus, OpenClaw and 40+ other clients

Works with any MCP client that speaks MCP over HTTP. The server URL is always:

https://api.mcp.ai/p_dfe

Per-client details: INSTALL.md.

Example prompts

Sync the new fiscal documents for my company
How many SEFAZ queries do I have left this hour?
Which supplier invoices came in this week, and from whom?
Fetch the invoice with access key 3526...
Render the DANFE PDF for the invoices I just synced
What is the total of the inbound invoices that arrived this month?

6 tools available

Details for each tool: docs/ferramentas.md (PT-BR)

What you can ask

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

DF-e: common questions

Is DF-e MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the DF-e safety report
How do I install DF-e?
It runs remotely at api.mcp.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does DF-e need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is DF-e maintained?
The last commit was 67 days ago (2026-08-30). The latest release is v0.1.0.
Is DF-e up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
How does DF-e compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,243 servers); tools 12 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from mcp-dir →