FileToPDF
Convert files, HTML, and Markdown to PDF via the FileToPDF API. Bring your own API key.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http filetopdf 'https://api.filetopdf.dev/mcp' --header 'x-api-key: <Your FileToPDF API key (sk_live_...). Get one free in one click at https://filetopdf.dev.>'
{
"mcpServers": {
"filetopdf": {
"type": "http",
"url": "https://api.filetopdf.dev/mcp",
"headers": {
"x-api-key": "<Your FileToPDF API key (sk_live_...). Get one free in one click at https://filetopdf.dev.>"
}
}
}
}
filetopdf-mcpclaude mcp add filetopdf -e 'FILETOPDF_API_KEY=<your filetopdf_api_key>' -- npx -y filetopdf-mcp@0.1.1
{
"mcpServers": {
"filetopdf": {
"command": "npx",
"args": [
"-y",
"filetopdf-mcp@0.1.1"
],
"env": {
"FILETOPDF_API_KEY": "<your filetopdf_api_key>"
}
}
}
}
Environment variables
FILETOPDF_API_KEYrequired secret Your FileToPDF API key (sk_live_...). Get one free in one click at https://filetopdf.dev.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
FileToPDF MCP server
A Model Context Protocol server for FileToPDF. It lets any MCP client — Claude Desktop, Claude Code, Cursor, Cline, VS Code, ChatGPT, n8n, Make, or your own agent — convert files, HTML, and Markdown to PDF through natural language: invoices, reports, documentation, DOCX/XLSX/PPTX, images, web pages, and more.
Bring your own API key — get one free, in one click, at https://filetopdf.dev (10 free conversions, no signup required).
Tools
| Tool | What it does |
|---|---|
get_account | Check the API key and show plan + remaining credits. Free, no credits used. |
convert_file | Convert a file from a public URL (DOCX, XLSX, PPTX, images, HTML, MD, PDF…) to PDF. |
convert_html | Render a raw HTML string (with optional CSS + layout options) to a pixel-perfect PDF via Chromium. |
convert_markdown | Render a raw Markdown string (with optional CSS + layout options) to a clean PDF. |
Each convert tool returns a metadata summary and the PDF as an embedded
application/pdf resource (base64), so capable clients can save the file. Set the
FILETOPDF_OUTPUT_DIR env var, or pass save_path, to also write the PDF to disk.
Layout options (landscape, paperWidth/Height, margins, scale, pdfa,
passwords, …) are available on Pro, Scale, and the free trial; on Starter/Basic
they return an upgrade error. Each successful conversion costs 1 credit; errors
are free.
Quick start (local / stdio)
Cursor — one-click install: **Add to Cursor** (then replace the placeholder with your key).
Claude Desktop / Cline / any stdio client — add to the MCP config
(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 or via MCP: Add Server):
{
"servers": {
"filetopdf": {
"type": "stdio",
"command": "npx",
"args": ["-y", "filetopdf-mcp"],
"env": { "FILETOPDF_API_KEY": "sk_live_YOUR_API_KEY" }
}
}
}
Hosted / remote (Streamable HTTP) — no install
A hosted endpoint is available at https://api.filetopdf.dev/mcp. Authenticate
with your own key via the x-api-key header, an Authorization: Bearer header, or
an ?apiKey= query parameter.
{
"mcpServers": {
"filetopdf": {
"type": "streamable-http",
"url": "https://api.filetopdf.dev/mcp",
"headers": { "x-api-key": "sk_live_YOUR_API_KEY" }
}
}
}
This is also the URL to paste into any platform with an MCP client step — n8n (MCP Client Tool), Make (MCP Client), Zapier (MCP Client beta), Relay.app (Call MCP tool), Flowise, Langflow, Dify, LibreChat, AnythingLLM, or agent frameworks (OpenAI Agents SDK, LangChain, CrewAI, Vercel AI SDK).
To self-host instead:
npm run build && npm run start:http # listens on $PORT (default 8080) at /mcp
A Dockerfile is included for container hosting (Smithery, Fly, Render, Cloud Run).
Develop & test
npm install
npm run build # tsc -> dist/
npm test # spawns the built stdio server, runs a live conversion
npm test reads FILETOPDF_API_KEY, or API_KEY= from a gitignored .env.
Links
- Website & instant free API key: https://filetopdf.dev
- API docs: https://filetopdf.dev/documentation
- Official MCP registry name:
dev.filetopdf/filetopdf-mcp
License
Frequently asked questions
What is FileToPDF?
Convert files, HTML, and Markdown to PDF via the FileToPDF API. Bring your own API key.
How do I install FileToPDF?
It runs as a remote server. In Claude Code: claude mcp add --transport http filetopdf 'https://api.filetopdf.dev/mcp' --header 'x-api-key: <Your FileToPDF API key (sk_live_...). Get one free in one click at https://filetopdf.dev.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does FileToPDF need an API key?
Yes. It expects FILETOPDF_API_KEY, x-api-key, which you set in its configuration.
Is FileToPDF open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains FileToPDF?
It is published by FileToPDF. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.