FileToPDF MCP server

A Model Context Protocol server for FileToPDF. It lets any MCP client — Claude Desktop, Cursor, Cline, VS Code, or your own agent — convert files, HTML, and Markdown to PDF through natural language. Bring your own API key (free trial key on the home page).

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 PDF.
convert_markdown	Render a raw Markdown string (with optional CSS + layout options) to 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.

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

npx filetopdf-mcp

Add to Claude Desktop (claude_desktop_config.json) or Cursor:

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

Get a key free at https://filetopdf.dev (instant trial key on the home page, 10 free conversions) or from the dashboard.

Hosted / remote (Streamable HTTP)

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

The key is read from the x-api-key header, an Authorization: Bearer header, or an ?apiKey= query parameter — so one endpoint serves every user with their own key. 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.

Publishing & listing

This server is built to be publicly discoverable on MCP marketplaces:

1. npm — npm publish makes npx filetopdf-mcp work (prerequisite for most directories).
2. GitHub — push a public repo (filetopdf/filetopdf-mcp); Glama and others auto-index it.
3. Smithery — connect the repo at https://smithery.ai/new; it builds the Dockerfile and hosts the HTTP server using smithery.yaml.
4. Official MCP Registry — publish server.json with the mcp-publisher CLI (namespace dev.filetopdf/* is verified via a DNS TXT record on filetopdf.dev).

License

MIT