# PDF.co (pypi · pdfco-mcp)

Official PDF.co MCP server: convert, merge, split, OCR, search and fill PDFs through the PDF.co API

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

## Components

- pypi · `pdfco-mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/pdfdotco-pdfco-mcp/pdfco-mcp.md), [page](https://verifymcp.io/servers/pdfdotco-pdfco-mcp/pdfco-mcp)

## Channel facts

- Registry: `pypi`
- Package: `pdfco-mcp`
- Version: `0.0.11`
- 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-11-05.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 2 of 40 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Licence could not be checked: the licence is shipped as a file inside the package, not declared as a standard (SPDX) licence identifier, so we cannot tell whether it is OSI-approved.
  - Actively maintained (last published 14 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 56/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 13622 tokens (~358/item across 38 items; 38 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 47/100
  - Stability observed for 14 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.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "pdf_merge" implies "merge" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 38 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the PDF.co MCP server?

PDF.co runs locally as a PyPI package, launched with uvx pdfco-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add pdfdotco-pdfco-mcp -- uvx pdfco-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "pdfdotco-pdfco-mcp": {
      "command": "uvx",
      "args": [
        "pdfco-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "pdfdotco-pdfco-mcp": {
      "command": "uvx",
      "args": [
        "pdfco-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add pdfdotco-pdfco-mcp -- uvx pdfco-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pdfdotco-pdfco-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "pdfco-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add pdfdotco-pdfco-mcp --command uvx --arg pdfco-mcp
```

### Hermes

```yaml
mcp_servers:
  pdfdotco-pdfco-mcp:
    command: "uvx"
    args: ["pdfco-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "pdfdotco-pdfco-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "pdfco-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add pdfdotco-pdfco-mcp -t stdio -c uvx -a pdfco-mcp
```

### Other

```json
{
  "mcpServers": {
    "pdfdotco-pdfco-mcp": {
      "command": "uvx",
      "args": [
        "pdfco-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-11-05 (score 70, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-11-04 (score 54, 0)

- [security regression] Provenance: unverified → fail

### 2026-11-03 (score 54, +6)

- [security regression] Provenance: fail → unverified
- [functional improvement] Stability: unverified → 0.40

### 2026-10-31 (score 48, −15)

- [security regression] Malware scan: pass → unverified

### 2026-10-30 (score 63, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-29 (score 48, −15)

- [security regression] Malware scan: pass → unverified

### 2026-10-23 (score 63, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-22 (score 48)

First indexed and scored.

## MCP tools (38)

### `pdf_to_json` (~451 tokens)

Pdf To Json

Convert PDF and scanned images into JSON representation with text, fonts, images, vectors, and formatting preserved using the /pdf/convert/to/json2 endpoint.
Ref: https://developer.pdf.co/api/pdf-to-json/basic.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_to_csv` (~438 tokens)

Pdf To Csv

Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables.
Ref: https://developer.pdf.co/api/pdf-to-csv.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_to_text` (~431 tokens)

Pdf To Text

Convert PDF and scanned images to text with layout preserved.
Ref: https://developer.pdf.co/api/pdf-to-text/basic.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_to_xls` (~440 tokens)

Pdf To Xls

Convert PDF and scanned images to XLS (Excel 97-2003) format.
Ref: https://developer.pdf.co/api/pdf-to-excel/xls.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_to_xlsx` (~439 tokens)

Pdf To Xlsx

Convert PDF and scanned images to XLSX (Excel 2007+) format.
Ref: https://developer.pdf.co/api/pdf-to-excel/xlsx.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_to_xml` (~429 tokens)

Pdf To Xml

Convert PDF and scanned images to XML format.
Ref: https://developer.pdf.co/api/pdf-to-xml.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_to_html` (~428 tokens)

Pdf To Html

Convert PDF and scanned images to HTML format.
Ref: https://developer.pdf.co/api/pdf-to-html.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_to_image` (~510 tokens)

Pdf To Image

Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF).
Ref:
 \- https://developer.pdf.co/api/pdf-to-image/jpg.md
 \- https://developer.pdf.co/api/pdf-to-image/png.md
 \- https://developer.pdf.co/api/pdf-to-image/webp.md
 \- https://developer.pdf.co/api/pdf-to-image/tiff.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `line_grouping` (string): Enables line grouping within table cells when set to '1'. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `rect` (string): Defines coordinates for extraction (e.g., '51.8,114.8,235.5,204.0'). (Optional)
- `type` (string): Type of image to convert to. (jpg, png, webp, tiff) (Optional)
- `unwrap` (boolean): Unwrap lines into a single line within table cells when lineGrouping is enabled. Must be true or false. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `document_to_pdf` (~365 tokens)

Document To Pdf

Convert various document types (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) into PDF.
Ref: https://developer.pdf.co/api/pdf-from-document/doc.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `autosize` (boolean): Controls automatic page sizing. If true, page dimensions adjust to content. If false, uses worksheet’s page setup. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (DOC, DOCX, RTF, TXT, XPS). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `csv_to_pdf` (~339 tokens)

Csv To Pdf

Convert CSV or spreadsheet files (XLS, XLSX) to PDF.
Ref: https://developer.pdf.co/api/pdf-from-document/csv.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `autosize` (boolean): Controls automatic page sizing. If true, page dimensions adjust to content. If false, uses worksheet’s page setup. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (CSV, XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `image_to_pdf` (~320 tokens)

Image To Pdf

Convert various image formats (JPG, PNG, TIFF) to PDF.
Ref: https://developer.pdf.co/api/pdf-from-image.md
\```

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (JPG, PNG, TIFF). Multiple files are supported (by providing a comma-separated list of URLs). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-I…

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `webpage_to_pdf` (~692 tokens)

Webpage To Pdf

Convert external webpage URL to PDF.
Ref: https://developer.pdf.co/api/pdf-from-url.md

The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them:
\- date: formatted print date
\- title: document title
\- url: document location
\- pageNumber: current page number
\- totalPages: total pages in the document
\- img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string.
For example, the following markup will generate Page N of NN page numbering:
\```html
\<span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>

Input parameters:

- `DoNotWaitFullLoad` (boolean): false by default. Set to true to skip waiting for full load (like full video load etc. that may affect the total conversion time). (Optional)
- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `footer` (string): User definable HTML for the footer to be applied on every page footer. (Optional)
- `header` (string): User definable HTML for the header to be applied on every page header. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `margins` (string): Set to CSS style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left). (Optional)
- `mediaType` (string): Uses print by default. Set to screen to convert HTML as it appears in a browser or print to convert as it appears for printing or none to set none as mediaType for CSS styles. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `orientation` (string): Set to Portrait or Landscape. Portrait is set by default. (Optional)
- `paperSize` (string): A4 is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by s…
- `printBackground` (boolean): true by default. Set to false to disable printing of background. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (external webpage URL).

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `html_to_pdf` (~723 tokens)

Html To Pdf

Convert HTML to PDF.
Ref: https://developer.pdf.co/api/pdf-from-html/convert.md

The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them:
\- date: formatted print date
\- title: document title
\- url: document location
\- pageNumber: current page number
\- totalPages: total pages in the document
\- img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string.
For example, the following markup will generate Page N of NN page numbering:
\```html
\<span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>

Input parameters:

- `DoNotWaitFullLoad` (boolean): false by default. Set to true to skip waiting for full load (like full video load etc. that may affect the total conversion time). (Optional)
- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `footer` (string): User definable HTML for the footer to be applied on every page footer. (Optional)
- `header` (string): User definable HTML for the header to be applied on every page header. (Optional)
- `html` (string, required): Input HTML code to be converted. To convert the link to a PDF use the /pdf/convert/from/url endpoint instead. If it is a local file, just pass the file content as a string.
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `margins` (string): Set to CSS style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left). (Optional)
- `mediaType` (string): Uses print by default. Set to screen to convert HTML as it appears in a browser or print to convert as it appears for printing or none to set none as mediaType for CSS styles. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `orientation` (string): Set to Portrait or Landscape. Portrait is set by default. (Optional)
- `paperSize` (string): A4 is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by s…
- `printBackground` (boolean): true by default. Set to false to disable printing of background. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `email_to_pdf` (~515 tokens)

Email To Pdf

Convert email to PDF.
Ref: https://developer.pdf.co/api/pdf-from-email.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `convertAttachments` (boolean): Set to false if you don’t want to convert attachments from the original email and want to embed them as original files (as embedded PDF attachments). Converts attachments that are supported by the PD…
- `embedAttachments` (boolean): Set to true to automatically embeds all attachments from original input email MSG or EML files into the final output PDF. Set it to false if you don’t want to embed attachments so it will convert onl…
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `margins` (string): Set to CSS style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left). (Optional)
- `orientation` (string): Set to Portrait or Landscape. Portrait is set by default. (Optional)
- `paperSize` (string): A4 is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by s…
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (MSG, EML). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `excel_to_csv` (~294 tokens)

Excel To Csv

Convert Excel(XLS, XLSX) to CSV.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/csv.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `worksheetIndex` (string): Index of the worksheet to convert. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `excel_to_json` (~293 tokens)

Excel To Json

Convert Excel(XLS, XLSX) to JSON.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/json.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `worksheetIndex` (string): Index of the worksheet to convert. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `excel_to_html` (~293 tokens)

Excel To Html

Convert Excel(XLS, XLSX) to HTML.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/html.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `worksheetIndex` (string): Index of the worksheet to convert. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `excel_to_txt` (~293 tokens)

Excel To Txt

Convert Excel(XLS, XLSX) to TXT.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/text.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `worksheetIndex` (string): Index of the worksheet to convert. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `excel_to_xml` (~293 tokens)

Excel To Xml

Convert Excel(XLS, XLSX) to XML.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/xml.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `worksheetIndex` (string): Index of the worksheet to convert. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `excel_to_pdf` (~259 tokens)

Excel To Pdf

Convert Excel(XLS, XLSX) to PDF.
Ref: https://developer.pdf.co/api/convert-from-excel/pdf.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file (XLS, XLSX). Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `worksheetIndex` (string): Index of the worksheet to convert. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `get_job_check` (~134 tokens)

Get Job Check

Check the status and results of a job
Status can be:
\- working: background job is currently in work or does not exist.
\- success: background job was successfully finished.
\- failed: background job failed for some reason (see message for more details).
\- aborted: background job was aborted.
\- unknown: unknown background job id. Available only when force is set to true for input request.

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `job_id` (string, required): The ID of the job to get the status of

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `wait_job_completion` (~97 tokens)

Wait Job Completion

Wait for a job to complete

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `interval` (integer): The interval to check the status of the job (seconds)
- `job_id` (string, required): The ID of the job to get the status of
- `timeout` (integer): The timeout to wait for the job to complete (seconds)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `upload_file` (~60 tokens)

Upload File

Upload a file to the PDF.co API

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `file_path` (string, required): The absolute path to the file to upload

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_merge` (~279 tokens)

Pdf Merge

Merge PDF from two or more PDF, DOC, XLS, images, even ZIP with documents and images into a new PDF.
Ref: https://developer.pdf.co/api/merge/various-files.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URLs to the source files as a comma-separated list. Supports PDF, DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, images, and more. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Bui…

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_split` (~317 tokens)

Pdf Split

Split a PDF into multiple PDF files using page indexes or page ranges.
Ref: https://developer.pdf.co/api/pdf-split/by-pages.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): Base file name for the generated output files. (Optional)
- `pages` (string, required): Comma-separated indices of pages (or page ranges) that you want to use. The first-page index is 1. For example: '1,3,5-7' or '1-2,4-'. Use '*' to split every page into separate files.
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `read_pdf_forms_info` (~236 tokens)

Read Pdf Forms Info

Extracts information about fillable PDF fields from an input PDF file.
Ref: https://developer.pdf.co/api/forms/info-reader.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `password` (string): Password of PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `fill_forms` (~317 tokens)

Fill Forms

Fill existing form fields in a PDF document.

Example fields format:
[
    {
        "fieldName": "field_name_from_form_info",
        "pages": "1",
        "text": "Value to fill"
    }
]

Use 'read_pdf_forms_info' first to get the fieldName values of the form.

Ref: https://developer.pdf.co/api/pdf-add.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `fields` (array, required): List of fields to fill. Each field is a dict with 'fieldName', 'pages', and 'text' properties.
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `create_fillable_forms` (~390 tokens)

Create Fillable Forms

Create new fillable form elements in a PDF document.

Example annotations format:
[
    {
        "text": "prefilled text",
        "x": 10,
        "y": 30,
        "size": 12,
        "pages": "0-",
        "type": "TextField",
        "id": "textfield1"
    },
    {
        "x": 100,
        "y": 150,
        "size": 12,
        "pages": "0-",
        "type": "Checkbox",
        "id": "checkbox1"
    }
]

Ref: https://developer.pdf.co/api/pdf-add.md

Input parameters:

- `annotations` (array, required): List of form annotations to create. Each annotation can be a textfield or checkbox with properties like 'x', 'y', 'size', 'pages', 'type', and 'id'.
- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `find_text` (~351 tokens)

Find Text

Find text in PDF and get coordinates. Supports regular expressions.
Ref: https://developer.pdf.co/api/pdf-find/basic.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `pages` (string): Comma-separated list of page indices (or ranges) to process. Leave empty for all pages. Example: '0,2-5,7-'. The first-page index is 0. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `regexSearch` (boolean): Set to True to enable regular expressions in the search string. (Optional)
- `searchString` (string, required): Text to search. Can support regular expressions if regexSearch is set to True.
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `wordMatchingMode` (string): Values can be either SmartMatch, ExactMatch, or None. (Optional)

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `find_table` (~279 tokens)

Find Table

Find tables in PDF and get their coordinates.
Ref: https://developer.pdf.co/api/pdf-find/table.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `pages` (string): Comma-separated list of page indices (or ranges) to process. Leave empty for all pages. Example: '0,2-5,7-'. The first-page index is 0. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_make_searchable` (~366 tokens)

Pdf Make Searchable

Convert scanned PDF documents or image files into a text-searchable PDF.
Runs OCR and adds an invisible text layer that can be used for text search.
Ref: https://developer.pdf.co/api/pdf-change-text-searchable/searchable.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `lang` (string): Language for OCR for scanned documents. Default is 'eng'. See PDF.co docs for supported languages. (Optional, Default: 'eng')
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_make_unsearchable` (~319 tokens)

Pdf Make Unsearchable

Make existing PDF document non-searchable by removing the text layer from it.
Ref: https://developer.pdf.co/api/pdf-change-text-searchable/unsearchable.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `pages` (string): Comma-separated page indices (e.g., '0, 1, 2-' or '1, 3-7'). Use '!' for inverted page numbers (e.g., '!0' for last page). Processes all pages if None. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_add_password` (~491 tokens)

Pdf Add Password

Add password protection to a PDF file.
Ref: https://developer.pdf.co/api/pdf-password/add.md

Input parameters:

- `allow_accessibility_support` (boolean): Allow or prohibit content extraction for accessibility needs.
- `allow_assembly_document` (boolean): Allow or prohibit assembling the document.
- `allow_content_extraction` (boolean): Allow or prohibit copying content from PDF document.
- `allow_fill_forms` (boolean): Allow or prohibit the filling of interactive form fields (including signature fields) in the PDF documents.
- `allow_modify_annotations` (boolean): Allow or prohibit interacting with text annotations and forms in PDF document.
- `allow_modify_document` (boolean): Allow or prohibit modification of PDF document.
- `allow_print_document` (boolean): Allow or prohibit printing PDF document.
- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `encryption_algorithm` (string): Encryption algorithm. Valid values: RC4_40bit, RC4_128bit, AES_128bit, AES_256bit. AES_128bit or higher is recommended.
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `owner_password` (string, required): The main owner password that is used for document encryption and for setting/removing restrictions.
- `password` (string): Password of the PDF file if it's already password-protected. (Optional)
- `print_quality` (string): Allowed printing quality. Valid values: HighResolution, LowResolution.
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.
- `user_password` (string): The optional user password will be asked for viewing and printing document.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_remove_password` (~249 tokens)

Pdf Remove Password

Remove password protection from a PDF file.
Ref: https://developer.pdf.co/api/pdf-password/remove.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `name` (string): File name for the generated output. (Optional)
- `password` (string): Password of the PDF file to be removed. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_info_reader` (~244 tokens)

Pdf Info Reader

Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more.
Ref: https://developer.pdf.co/api/pdf-info-reader.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `password` (string): Password of the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `ai_invoice_parser` (~104 tokens)

Ai Invoice Parser

AI Invoice Parser: Extracts data from invoices using AI.
Ref: https://developer.pdf.co/api/ai-invoice-parser.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `extract_attachments` (~204 tokens)

Extract Attachments

Extracts attachments from a source PDF file.
Ref: https://developer.pdf.co/api/pdf-extract-attachments.md

Input parameters:

- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `expiration`: Lifetime of the output link in minutes; the output file is deleted afterwards. API default is 60; the maximum depends on the plan. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `password` (string): Password of PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

### `pdf_add_annotations_images_fields` (~940 tokens)

Pdf Add Annotations Images Fields

Add text, images, forms, other PDFs, fill forms, links to external sites and external PDF files. You can update or modify PDF and scanned PDF files.

This tool supports three main ways to add content:

1\. **annotations**: Add text, links, shapes, etc.
   Properties: text, x, y, size, pages, color, link, fontName, fontItalic, fontBold, fontStrikeout, fontUnderline

2\. **images**: Add images or other PDF content
   Properties: url, x, y, width, height, pages

3\. **fields**: Fill existing form fields
   Properties: fieldName, pages, text, fontName, size, fontBold, fontItalic, fontStrikeout, fontUnderline

Example annotations:
[{"text": "Sample Text - Click here to test link", "x": 250, "y": 240, "size": 24, "pages": "0-", "color": "CCBBAA", "link": "https://pdf.co/", "fontName": "Comic Sans MS", "fontItalic": true, "fontBold": true, "fontStrikeout": false, "fontUnderline": true}]

Example images:
[{"url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png", "x": 270, "y": 150, "width": 159, "height": 43, "pages": "0"}]

Example fields:
[{"fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]", "pages": "1", "text": "Joan B.", "fontName": "Arial", "size": 6, "fontBold": true, "fontItalic": true, "fontStrikeout": true, "fontUnderline": true}]

Ref: https://developer.pdf.co/api/pdf-add.md

Input parameters:

- `annotations` (array): Array of annotation objects to add text, links, shapes, etc. Each object can have: 'text' (string), 'x' (number), 'y' (number), 'size' (number), 'pages' (string), 'color' (string hex), 'link' (string…
- `api_key` (string): PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)
- `encrypt` (boolean): Encrypt output file. (Optional)
- `expiration` (integer): Set the expiration time for the output link in minutes. After this specified duration, any generated output file(s) will be automatically deleted. (Optional)
- `fields` (array): Array of form field objects to fill PDF form fields. Each object can have: 'fieldName' (string), 'pages' (string), 'text' (string), 'fontName' (string), 'size' (number), 'fontBold' (boolean), 'fontIt…
- `flatten` (boolean): Flatten filled form fields and annotations into PDF content. Set to true to disable editing of filled form fields in the output PDF. (Optional)
- `httppassword` (string): HTTP auth password if required to access source url. (Optional)
- `httpusername` (string): HTTP auth user name if required to access source url. (Optional)
- `images` (array): Array of image objects to add images to PDF. Each object can have: 'url' (string), 'x' (number), 'y' (number), 'width' (number), 'height' (number), 'pages' (string). (Optional)
- `name` (string): File name for the generated output. (Optional)
- `password` (string): Password for the PDF file. (Optional)
- `profiles` (string): Extra engine options for this endpoint as a JSON object encoded in a string. The options differ per endpoint; see https://developer.pdf.co/api/profiles. (Optional)
- `url` (string, required): URL to the source PDF file. Supports publicly accessible links including Google Drive, Dropbox, PDF.co Built-In Files Storage. Use 'upload_file' tool to upload local files.

Output parameters:

- `content`
- `credits_remaining`
- `credits_used`
- `status` (string)
- `tips`

## Diagnostics

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

## Score history

- 2026-11-05: 70
- 2026-11-04: 54
- 2026-11-03: 54
- 2026-11-02: 48
- 2026-11-01: 48
- 2026-10-31: 48
- 2026-10-30: 63
- 2026-10-29: 48
- 2026-10-28: 63
- 2026-10-27: 63
- 2026-10-26: 63
- 2026-10-25: 63
- 2026-10-24: 63
- 2026-10-23: 63
- 2026-10-22: 48

## Common questions

### What is the PDF.co MCP server?

PDF.co is an MCP server listed in the public MCP registry as io.github.pdfdotco/pdfco-mcp. Official PDF.co MCP server: convert, merge, split, OCR, search and fill PDFs through the PDF.co API. This page covers its PyPI package (pdfco-mcp).

### Is the PDF.co MCP server safe to use?

PDF.co scores 70 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the PDF.co MCP server expose?

PDF.co exposes 38 tools: pdf_to_json, pdf_to_csv, pdf_to_text, pdf_to_xls, pdf_to_xlsx, and 33 more. Their descriptions and schemas cost roughly 13,622 tokens of context every time the server is loaded.

### Is the PDF.co MCP server still maintained?

PDF.co is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the PDF.co MCP server?

VerifyMCP ran 15 checks on PDF.co, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about PDF.co: License. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- PyPI project: https://pypi.org/project/pdfco-mcp/
- Socket report: https://socket.dev/pypi/package/pdfco-mcp
- Repository: https://github.com/pdfdotco/pdfco-mcp
- Website: https://developer.pdf.co/
- Changelog RSS feed: https://verifymcp.io/servers/pdfdotco-pdfco-mcp/pdfco-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/pdfdotco-pdfco-mcp/pdfco-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/pdfdotco-pdfco-mcp/pdfco-mcp.json
- HTML version of this page: https://verifymcp.io/servers/pdfdotco-pdfco-mcp/pdfco-mcp