# FileToPDF (npm · filetopdf-mcp)

Convert files, HTML, and Markdown to PDF via the FileToPDF API. Bring your own API key.

- Trust score: 62/100 (medium)
- Change this week: +38
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.filetopdf.dev`: 68/100, [markdown](https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/api.md), [page](https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/api)
- npm · `filetopdf-mcp`: 62/100 (this document), [markdown](https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/filetopdf-mcp.md), [page](https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/filetopdf-mcp)

## Channel facts

- Registry: `npm`
- Package: `filetopdf-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 53 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1224 tokens (~306/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add dev-filetopdf-filetopdf-mcp -- npx -y filetopdf-mcp
```

### Codex

```bash
codex mcp add dev-filetopdf-filetopdf-mcp -- npx -y filetopdf-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dev-filetopdf-filetopdf-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "filetopdf-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dev-filetopdf-filetopdf-mcp --command npx --arg -y --arg filetopdf-mcp
```

### Hermes

```yaml
mcp_servers:
  dev-filetopdf-filetopdf-mcp:
    command: "npx"
    args: ["-y", "filetopdf-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "dev-filetopdf-filetopdf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "filetopdf-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 62, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security improvement] Install scripts: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] License: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Schema quality: unverified → excellent
- [functional] Licence: MIT

### 2026-08-01 (score 18, −5)

- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified

### 2026-07-31 (score 23, −19)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 42, +18)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: unverified
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail

### 2026-07-27 (score 24)

First indexed and scored.

## MCP tools (4)

### `get_account` (~84 tokens)

Get FileToPDF account status

Check the FileToPDF connection and return the plan, remaining conversion credits, and subscription status. Free — never costs credits. Call it to verify the API key works, or after a failed conversion to see whether credits ran out. No API key yet? Anyone can get one free, in one click, at https://filetopdf.dev (10 free conversions, no signup).

### `convert_file` (~307 tokens)

Convert a file (by URL) to PDF

Convert a document at a public URL into a PDF. Handles Office documents (DOCX, XLSX, PPTX, ODT, RTF, TXT, CSV…), images (PNG, JPG, WebP…), web pages/HTML files, Markdown files, and existing PDFs (passthrough) — the conversion engine is auto-detected from the file extension. Use this when the source lives at a URL; for raw HTML or Markdown strings use convert_html / convert_markdown instead. Returns the PDF as an embedded application/pdf resource (optionally also written to disk via save_path). Costs 1 credit on success; failed conversions are free.

Input parameters:

- `landscape` (boolean): Render in landscape orientation. (Pro/Scale/trial only.)
- `nativePageRanges` (string): Page ranges to include, e.g. "1-3".
- `ownerPassword` (string): Owner password controlling permissions on the resulting PDF.
- `password` (string): Password to open a protected source document.
- `pdfa` (string): PDF/A conformance level, e.g. "PDF/A-2b". (Pro/Scale/trial only.)
- `pdfua` (boolean): Produce an accessible PDF/UA document.
- `save_path` (string): Optional absolute path to also write the PDF to on disk.
- `url` (string, required): Public http(s) URL of the file to download and convert.
- `userPassword` (string): Password required to open the resulting PDF.

### `convert_html` (~413 tokens)

Convert HTML to PDF

Render a raw HTML string into a pixel-perfect PDF with a real Chromium engine — ideal for generating invoices, reports, receipts, certificates, letters, and other documents from templates. Optional css is injected into the document <head>; full layout control via paper size, margins, landscape, scale, page ranges, background printing, PDF/A archival conformance, and password protection. Returns the PDF as an embedded application/pdf resource (optionally also written to disk via save_path). Costs 1 credit on success; failed conversions are free.

Input parameters:

- `css` (string): Optional CSS, injected into the document <head>.
- `html` (string, required): The HTML markup to render.
- `landscape` (boolean): Render in landscape orientation. (Pro/Scale/trial only.)
- `marginBottom` (string): Bottom margin in inches.
- `marginLeft` (string): Left margin in inches.
- `marginRight` (string): Right margin in inches.
- `marginTop` (string): Top margin in inches.
- `nativePageRanges` (string): Page ranges to include, e.g. "1-3,5".
- `ownerPassword` (string): Owner password controlling permissions on the resulting PDF.
- `paperHeight` (string): Paper height in inches.
- `paperWidth` (string): Paper width in inches, or with a unit e.g. "210mm".
- `pdfa` (string): PDF/A conformance level, e.g. "PDF/A-2b". (Pro/Scale/trial only.)
- `pdfua` (boolean): Produce an accessible PDF/UA document.
- `preferCssPageSize` (boolean): Use the page size declared in CSS @page rules.
- `printBackground` (boolean): Print background graphics/colors.
- `save_path` (string): Optional absolute path to also write the PDF to on disk.
- `scale` (string): Render scale, 0.1–2.0.
- `userPassword` (string): Password required to open the resulting PDF.

### `convert_markdown` (~420 tokens)

Convert Markdown to PDF

Render a Markdown string into a clean, professional PDF — the fastest way to turn notes, reports, documentation, summaries, or any agent-written text into a shareable document. A sensible default stylesheet is applied when no css is given; pass custom CSS to fully control typography and branding, plus layout options (paper size, margins, landscape, page ranges, PDF/A, passwords). Returns the PDF as an embedded application/pdf resource (optionally also written to disk via save_path). Costs 1 credit on success; failed conversions are free.

Input parameters:

- `css` (string): Optional CSS to style the rendered Markdown (overrides the default stylesheet).
- `landscape` (boolean): Render in landscape orientation. (Pro/Scale/trial only.)
- `marginBottom` (string): Bottom margin in inches.
- `marginLeft` (string): Left margin in inches.
- `marginRight` (string): Right margin in inches.
- `marginTop` (string): Top margin in inches.
- `markdown` (string, required): The Markdown content to render.
- `nativePageRanges` (string): Page ranges to include, e.g. "1-3,5".
- `ownerPassword` (string): Owner password controlling permissions on the resulting PDF.
- `paperHeight` (string): Paper height in inches.
- `paperWidth` (string): Paper width in inches, or with a unit e.g. "210mm".
- `pdfa` (string): PDF/A conformance level, e.g. "PDF/A-2b". (Pro/Scale/trial only.)
- `pdfua` (boolean): Produce an accessible PDF/UA document.
- `preferCssPageSize` (boolean): Use the page size declared in CSS @page rules.
- `printBackground` (boolean): Print background graphics/colors.
- `save_path` (string): Optional absolute path to also write the PDF to on disk.
- `scale` (string): Render scale, 0.1–2.0.
- `userPassword` (string): Password required to open the resulting PDF.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/filetopdf-mcp#diagnostics

## Score history

- 2026-08-03: 62
- 2026-08-02: 62
- 2026-08-01: 18
- 2026-07-31: 23
- 2026-07-30: 42
- 2026-07-28: 42
- 2026-07-27: 24

## Links

- npm package: https://www.npmjs.com/package/filetopdf-mcp
- Socket report: https://socket.dev/npm/package/filetopdf-mcp
- Repository: https://github.com/FileToPDF/filetopdf-mcp
- Website: https://filetopdf.dev/
- Changelog RSS feed: https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/filetopdf-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/filetopdf-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/dev-filetopdf-filetopdf-mcp/filetopdf-mcp