# io.usefulapi/api2pdf (remote · api2pdf.usefulapi.io)

MCP server for Api2Pdf — generate PDFs & images from HTML, URLs or office files; merge, barcodes.

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

## Components

- remote · `api2pdf.usefulapi.io`: 70/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-api2pdf/api2pdf.md), [page](https://verifymcp.io/servers/io-usefulapi-api2pdf/api2pdf)

## Channel facts

- Endpoint: `https://api2pdf.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, 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.

- **Endpoint Security**: 78/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 61/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3850 tokens (~240/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **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**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-api2pdf https://api2pdf.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-api2pdf]
url = "https://api2pdf.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-api2pdf": {
      "type": "remote",
      "url": "https://api2pdf.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-api2pdf --url https://api2pdf.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-api2pdf:
    url: "https://api2pdf.usefulapi.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-api2pdf": {
      "type": "http",
      "url": "https://api2pdf.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## 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-03 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 69, +41)

- [security improvement] Authorization: unverified → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] Tool coverage: unverified → 100

### 2026-08-01 (score 28, −40)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-07-31 (score 68, +3)

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

### 2026-07-30 (score 65, −2)

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

### 2026-07-29 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 66, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 65, +53)

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

## MCP tools (16)

### `api2pdf_html_to_pdf` (~289 tokens)

HTML to PDF (Chrome)

Render an HTML string to a PDF using the headless-Chrome engine. Returns a { FileUrl } link (valid ~24h) by default. Great for invoices, reports, and letters produced as HTML. BILLED per document. Api2Pdf API: POST /chrome/pdf/html.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `html` (string, required): The HTML source to render into a PDF.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_url_to_pdf` (~292 tokens)

URL to PDF (Chrome)

Fetch a web page by URL and render it to a PDF using headless Chrome. Returns a { FileUrl } (valid ~24h). Use extraHTTPHeaders to pass auth for a protected page. BILLED. Api2Pdf API: POST /chrome/pdf/url.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `url` (string, required): The URL of the web page Api2Pdf will fetch and render to PDF.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_markdown_to_pdf` (~270 tokens)

Markdown to PDF (Chrome)

Render a Markdown string to a PDF using headless Chrome. Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /chrome/pdf/markdown.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `markdown` (string, required): The Markdown source to render into a PDF.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_html_to_image` (~280 tokens)

HTML to image (Chrome)

Render an HTML string to an image using headless Chrome. Returns a { FileUrl } (valid ~24h) by default, or base64 bytes with output_binary:true. BILLED. Api2Pdf API: POST /chrome/image/html.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `html` (string, required): The HTML source to render into an image.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_url_to_image` (~271 tokens)

URL to image / screenshot (Chrome)

Take a screenshot of a live web page by URL using headless Chrome. Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /chrome/image/url.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `url` (string, required): The URL of the web page to screenshot.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_wkhtml_to_pdf` (~296 tokens)

HTML to PDF (wkhtmltopdf)

Render an HTML string to a PDF using the wkhtmltopdf engine — an alternate to Chrome that supports a table of contents (pass enableToc / tocOptions inside `options`). Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /wkhtml/pdf/html.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `html` (string, required): The HTML source to render into a PDF.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_office_to_pdf` (~292 tokens)

Office document to PDF (LibreOffice)

Convert an office document (Word, Excel, PowerPoint, ODT, and many more) at a URL to a PDF using LibreOffice. Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /libreoffice/any-to-pdf.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `url` (string, required): URL of the source document to convert to PDF.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_merge_pdfs` (~283 tokens)

Merge PDFs (PDFSharp)

Merge several existing PDFs (given as URLs, in order) into a single PDF. Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /pdfsharp/merge.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `urls` (array, required): URLs of the PDFs to merge, in the order they should appear (at least two).
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_compress_pdf` (~271 tokens)

Compress PDF (PDFSharp)

Compress an existing PDF (given as a URL) to reduce its file size. Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /pdfsharp/compress.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `url` (string, required): URL of the PDF to compress.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_extract_pages` (~348 tokens)

Extract PDF pages (PDFSharp)

Extract a range of pages from an existing PDF (given as a URL) into a new PDF. `start`/`end` are 0-based page indices; omit `end` to extract a single page. Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /pdfsharp/extract-pages.

Input parameters:

- `end` (integer): 0-based index of the last page to extract. Omit for a single page (just `start`).
- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `start` (integer): 0-based index of the first page to extract. Default 0.
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `url` (string, required): URL of the source PDF.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_add_password` (~315 tokens)

Password-protect PDF (PDFSharp)

Encrypt an existing PDF (given as a URL) with a user password (required to open) and an optional owner password (controls permissions). Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /pdfsharp/password.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `ownerpassword` (string): Optional owner password controlling permissions (printing, editing, etc.).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `url` (string, required): URL of the PDF to protect.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.
- `userpassword` (string, required): Password required to OPEN the resulting PDF.

### `api2pdf_convert_to_markdown` (~297 tokens)

Convert document to Markdown (MarkItDown)

Convert a document or file (given as a URL — PDF, Office docs, and more) to Markdown text via MarkItDown. Great for feeding a document's contents back to an agent. Returns a { FileUrl } (valid ~24h). BILLED. Api2Pdf API: POST /markitdown.

Input parameters:

- `extraHTTPHeaders` (object): Extra HTTP headers Api2Pdf forwards when it fetches a source URL (e.g. auth for a protected page/file).
- `fileName` (string): A name for the generated file, e.g. 'invoice.pdf'.
- `inline` (boolean): If true (Api2Pdf default), the generated file is served inline; if false, as an attachment.
- `options` (object): Engine-specific render options (page size, margins, orientation, headers/footers, etc.). Passed through verbatim to Api2Pdf.
- `output_binary` (boolean): If true, return the raw file bytes as base64 instead of a FileUrl. Default false (recommended for agents — returns a short-lived link).
- `storage` (object): Custom storage target, used when useCustomStorage is true.
- `url` (string, required): URL of the document/file to convert to Markdown.
- `useCustomStorage` (boolean): If true, Api2Pdf uploads the result to your own storage (see `storage`) instead of hosting it.

### `api2pdf_generate_barcode` (~214 tokens)

Generate barcode / QR code (Zebra)

Generate a barcode or QR code image. `format` is the symbology (e.g. 'QRCode', 'Code128', 'PDF417', 'DataMatrix') and `value` is the string to encode. Returns a { FileUrl } (valid ~24h) by default, or base64 with output_binary:true. BILLED. Api2Pdf API: GET /zebra.

Input parameters:

- `format` (string, required): Barcode/QR symbology, e.g. 'QRCode', 'Code128', 'PDF417', 'DataMatrix'.
- `height` (integer): Image height in pixels.
- `output_binary` (boolean): If true, return the raw image bytes as base64 instead of a FileUrl. Default false.
- `showlabel` (boolean): If true, render the encoded value as a human-readable label under the barcode.
- `value` (string, required): The string to encode in the barcode/QR code.
- `width` (integer): Image width in pixels.

### `api2pdf_get_balance` (~34 tokens)

Get account balance

Return the remaining balance / usage for the configured Api2Pdf account. Api2Pdf API: GET /balance.

### `api2pdf_get_status` (~31 tokens)

Get service status

Return the current Api2Pdf service / health status. Api2Pdf API: GET /status.

### `api2pdf_delete_file` (~67 tokens)

Delete a generated file

Delete a previously generated file by its ResponseId (the `ResponseId` returned in a generation response). Api2Pdf API: DELETE /file/{ResponseId}.

Input parameters:

- `responseId` (string, required): The ResponseId of the generated file to delete (from a prior generation response).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-api2pdf/api2pdf#diagnostics

## Score history

- 2026-08-03: 70
- 2026-08-02: 69
- 2026-08-01: 28
- 2026-07-31: 68
- 2026-07-30: 65
- 2026-07-29: 67
- 2026-07-28: 66
- 2026-07-27: 65
- 2026-07-26: 12

## Links

- Remote endpoint: https://api2pdf.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-api2pdf/api2pdf/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-api2pdf/api2pdf/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-api2pdf/api2pdf