# DF-e — MCP server on mcp.ai
> Pulls electronic fiscal documents issued AGAINST your Brazilian company (supplier invoices, events, CT-e) straight from SEFAZ, using your A1 digital certificate. Incremental NSU sync with query-rate control so your tax ID never gets blocked. Also renders the DANFE PDF from the XML, which is the printable document. Does not return invoices your own company issued: SEFAZ does not release those to the issuer.

By: mcp.ai · official
Page: https://mcp.ai/dfe

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_dfe?ms=1792030680000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/dfe/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/dfe/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
Install guide (prompt + clients + REST), markdown: https://mcp.ai/dfe/index.md
How to use (MCP or REST), markdown: https://mcp.ai/dfe/skill.md
Postman collection (v2.1): https://mcp.ai/dfe/postman.json

## Tools
- dfe_consultar_chave(chave: string, account?: string) — Busca um documento pela chave de acesso de 44 dígitos.
- dfe_consultar_nsu(nsu: string, account?: string) — 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_danfe(xml?: string, chave?: string, nsu?: string, account?: string) — 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.
- dfe_list_accounts(account?: string) — Lista os CNPJs conectados neste install (razão social, CNPJ e UF).
- dfe_orcamento(account?: string) — 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 
- dfe_sincronizar(ult_nsu?: string, forcar_nsu?: boolean, account?: string) — Puxa os documentos fiscais NOVOS emitidos contra este CNPJ (nota de fornecedor, evento, CT-e) — NFeDistribuicaoDFe.

## Example prompts
- "Sync new fiscal documents for my company"
- "How many queries do I have left this hour?"

## Links
Docs: https://mcp.ai/docs/mcps/dfe
Website: https://mcp.ai/mcps/dfe