FileToPDF

oficial

Converta arquivos (DOCX, XLSX, PPTX, imagens), HTML e Markdown para PDFs com qualidade pixel-perfeita — npx stdio ou Streamable HTTP hospedado, chave de API gratuita em um clique.

GitHub
2

O que você pode fazer com File To PDF MCP?

  • Verificar status da conta e créditos restantes — Peça ao assistente para chamar get_account para verificar sua chave de API, plano e saldo de conversão.
  • Converter um arquivo hospedado publicamente para PDF — Forneça uma URL de um arquivo DOCX, XLSX, PPTX, imagem, HTML ou MD e faça com que convert_file retorne o PDF.
  • Renderizar uma string HTML como PDF — Envie HTML bruto com CSS opcional e opções de layout para convert_html para uma saída perfeita baseada em Chromium.
  • Transformar Markdown em um PDF limpo — Envie uma string Markdown para convert_markdown com controles opcionais de estilo e layout.
  • Salvar o PDF gerado no disco — Defina a variável de ambiente FILETOPDF_OUTPUT_DIR ou passe um save_path para gravar o arquivo PDF localmente.

Documentação

Servidor MCP FileToPDF

npm smithery badge Install MCP Server

Um servidor Model Context Protocol para FileToPDF. Ele permite que qualquer cliente MCP — Claude Desktop, Claude Code, Cursor, Cline, VS Code, ChatGPT, n8n, Make ou seu próprio agente — converta arquivos, HTML e Markdown para PDF através de linguagem natural: faturas, relatórios, documentação, DOCX/XLSX/PPTX, imagens, páginas web e muito mais.

Traga sua própria chave de API — obtenha uma gratuitamente, em um clique, em https://filetopdf.dev (10 conversões gratuitas, sem necessidade de cadastro).

Ferramentas

FerramentaO que faz
get_accountVerifica a chave de API e exibe o plano + créditos restantes. Gratuito, sem consumo de créditos.
convert_fileConverte um arquivo a partir de uma URL pública (DOCX, XLSX, PPTX, imagens, HTML, MD, PDF…) para PDF.
convert_htmlRenderiza uma string HTML bruta (com CSS opcional + opções de layout) para um PDF perfeito em pixels via Chromium.
convert_markdownRenderiza uma string Markdown bruta (com CSS opcional + opções de layout) para um PDF limpo.

Cada ferramenta de conversão retorna um resumo de metadados e o PDF como um recurso application/pdf incorporado (base64), para que clientes compatíveis possam salvar o arquivo. Defina a variável de ambiente FILETOPDF_OUTPUT_DIR ou passe save_path para também gravar o PDF em disco.

Opções de layout (landscape, paperWidth/Height, margens, scale, pdfa, senhas, …) estão disponíveis nos planos Pro, Scale e no teste gratuito; no Starter/Basic elas retornam um erro de upgrade. Cada conversão bem-sucedida custa 1 crédito; erros são gratuitos.

Início rápido (local / stdio)

Cursor — instalação com um clique: Adicionar ao Cursor (depois substitua o placeholder pela sua chave).

Claude Desktop / Cline / qualquer cliente stdio — adicione à configuração MCP (claude_desktop_config.json, cline_mcp_settings.json, …):

{
  "mcpServers": {
    "filetopdf": {
      "command": "npx",
      "args": ["-y", "filetopdf-mcp"],
      "env": { "FILETOPDF_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

Claude Code:

claude mcp add filetopdf -e FILETOPDF_API_KEY=sk_live_YOUR_API_KEY -- npx -y filetopdf-mcp

VS Code (.vscode/mcp.json ou via MCP: Adicionar Servidor):

{
  "servers": {
    "filetopdf": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "filetopdf-mcp"],
      "env": { "FILETOPDF_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

Hospedado / remoto (HTTP Transmissível) — sem instalação

Um endpoint hospedado está disponível em https://api.filetopdf.dev/mcp. Autentique-se com sua própria chave via cabeçalho x-api-key, cabeçalho Authorization: Bearer ou parâmetro de consulta ?apiKey=.

{
  "mcpServers": {
    "filetopdf": {
      "type": "streamable-http",
      "url": "https://api.filetopdf.dev/mcp",
      "headers": { "x-api-key": "sk_live_YOUR_API_KEY" }
    }
  }
}

Esta também é a URL para colar em qualquer plataforma com uma etapa de cliente MCP — n8n (Ferramenta Cliente MCP), Make (Cliente MCP), Zapier (Cliente MCP beta), Relay.app (Chamar ferramenta MCP), Flowise, Langflow, Dify, LibreChat, AnythingLLM, ou frameworks de agentes (OpenAI Agents SDK, LangChain, CrewAI, Vercel AI SDK).

Para auto-hospedar em vez disso:

npm run build && npm run start:http   # listens on $PORT (default 8080) at /mcp

Um Dockerfile está incluído para hospedagem em contêiner (Smithery, Fly, Render, Cloud Run).

Desenvolver & testar

npm install
npm run build          # tsc -> dist/
npm test               # spawns the built stdio server, runs a live conversion

npm test lê FILETOPDF_API_KEY ou API_KEY= de um .env ignorado pelo git.

Links

Licença

MIT