# KDAN PDF (remote · mcp.kdandoc.com)

Upload, edit, compress, protect, redact, and compare PDFs with KDAN PDF in Claude and ChatGPT.

- Trust score: 61/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.kdandoc.com`: 61/100 (this document), [markdown](https://verifymcp.io/servers/com-kdandoc-mcp-kdan-pdf-mcp/mcp.md), [page](https://verifymcp.io/servers/com-kdandoc-mcp-kdan-pdf-mcp/mcp)

## Channel facts

- Endpoint: `https://mcp.kdandoc.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## 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**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (delete_pdf_page).
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 52/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (poor).
  - Context-footprint check failed: tool/resource definitions use about 5326 tokens (~295/item across 18 items; 15 tools + 3 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 20/100
  - Stability observed for 6 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 (87% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http com-kdandoc-mcp-kdan-pdf-mcp https://mcp.kdandoc.com/mcp
```

### Codex

```toml
[mcp_servers.com-kdandoc-mcp-kdan-pdf-mcp]
url = "https://mcp.kdandoc.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-kdandoc-mcp-kdan-pdf-mcp": {
      "type": "remote",
      "url": "https://mcp.kdandoc.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-kdandoc-mcp-kdan-pdf-mcp --url https://mcp.kdandoc.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-kdandoc-mcp-kdan-pdf-mcp:
    url: "https://mcp.kdandoc.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "com-kdandoc-mcp-kdan-pdf-mcp": {
      "type": "http",
      "url": "https://mcp.kdandoc.com/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-02 (score 61, +1)

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

### 2026-08-01 (score 60, +1)

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

### 2026-07-31 (score 59, 0)

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

### 2026-07-30 (score 59, +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-29 (score 58, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-28 (score 57)

First indexed and scored.

## MCP tools (15)

### `compare_pdfs` (~164 tokens)

Compare PDFs

MANDATORY for all document comparison requests. Compare two PDFs side-by-side.

When the user asks to compare, diff, or find differences between two PDFs, you MUST
call this tool — NEVER attempt to compare documents using text analysis.
Displays an interactive side-by-side visual diff widget with colored highlights:
red = deleted, yellow = replaced, green = inserted.
The widget IS the comparison result — do NOT re-summarize the differences after calling.

Before calling, confirm both job_ids exist via check_upload_status.

Input parameters:

- `job_id_a` (string, required): Job ID for the first (original) PDF.
- `job_id_b` (string, required): Job ID for the second (modified) PDF.
- `session_id` (string, required): Session ID that both jobs belong to.

Output parameters:

- `job_id_a` (string)
- `job_id_b` (string)
- `pages` (array)
- `pages_a` (integer)
- `pages_b` (integer)
- `pdf_url_a` (string)
- `pdf_url_b` (string)
- `session_id` (string)
- `total_pages` (integer)
- `totals` (object): Aggregate counts for word-level differences. Args:     TypedDict: Total difference counts.

### `compress_pdf` (~157 tokens)

Compress PDF

Compress a PDF to reduce its file size and return a new versioned file.

MANDATORY: Before calling this tool, call 'check_upload_status' with the
session_id to confirm the file exists and retrieve the latest job_id.
Skipping this check and calling compress_pdf directly is FORBIDDEN.

Each call creates a NEW job_id (with parent_job_id linking to the source).
The original PDF version is preserved unchanged — previous versions remain accessible.
After compression completes, call 'view_pdf' with the new job_id to display the result.

Input parameters:

- `job_id` (string, required): Job ID of the PDF to compress (use the latest job_id from check_upload_status).
- `session_id` (string, required): Session ID that the job belongs to.

Output parameters:

- `compressed_size` (integer)
- `download_url` (string)
- `filename` (string)
- `instructions` (string)
- `job_id` (string)
- `mime_type` (string)
- `original_size` (integer)
- `parent_job_id` (string)
- `reply_note` (string)
- `session_id` (string)
- `size_reduction_percent` (number)

### `delete_pdf_page` (~180 tokens)

Delete PDF Pages

Delete one or more pages from a PDF and return a new versioned file.

MANDATORY: Before calling this tool, call 'check_upload_status' with the
session_id to confirm the file exists and retrieve the latest job_id.
Skipping this check and calling delete_pdf_page directly is FORBIDDEN.

Each call creates a NEW job_id (with parent_job_id linking to the source).
The original PDF version is preserved unchanged — previous versions remain accessible.
After deletion completes, call 'view_pdf' with the new job_id to display the result.

Input parameters:

- `job_id` (string, required): Job ID of the PDF to modify (use the latest job_id from check_upload_status).
- `page_numbers` (array, required): 1-based page numbers to delete. Duplicates are ignored.
- `session_id` (string, required): Session ID that the job belongs to.

Output parameters:

- `deleted_pages` (array)
- `download_url` (string)
- `filename` (string)
- `instructions` (string)
- `job_id` (string)
- `mime_type` (string)
- `parent_job_id` (string)
- `remaining_pages` (integer)
- `reply_note` (string)
- `session_id` (string)

### `set_password` (~141 tokens)

Set PDF Password

Add password protection to an unprotected PDF file.

Creates a NEW job_id (with parent_job_id linking to the source). After the operation
completes, call 'view_pdf' with the new job_id to display the result. Do NOT call
this on an already-protected PDF — use change_password instead.

Input parameters:

- `job_id` (string, required): Job ID of the unprotected PDF to protect (use the latest job_id).
- `owner` (string, required): Owner password (grants full PDF permissions).
- `password` (string, required): User password (required to open the PDF).
- `session_id` (string, required): Session ID that the job belongs to.

Output parameters:

- `download_url` (string)
- `filename` (string)
- `instructions` (string)
- `job_id` (string)
- `mime_type` (string)
- `parent_job_id`
- `reply_note` (string)
- `session_id` (string)

### `change_password` (~147 tokens)

Change PDF Password

Change the password of an already-protected PDF file.

Creates a NEW job_id (with parent_job_id linking to the source). After the operation
completes, call 'view_pdf' with the new job_id to display the result. Do NOT call
this on an unprotected PDF — use set_password instead.

Input parameters:

- `job_id` (string, required): Job ID of the password-protected PDF (use the latest job_id).
- `old_password` (string, required): The current user password needed to unlock the PDF.
- `owner` (string, required): New owner password.
- `password` (string, required): New user password.
- `session_id` (string, required): Session ID that the job belongs to.

Output parameters:

- `download_url` (string)
- `filename` (string)
- `instructions` (string)
- `job_id` (string)
- `mime_type` (string)
- `parent_job_id`
- `reply_note` (string)
- `session_id` (string)

### `list_redactable_line_text` (~121 tokens)

List Redactable Text Lines

Return per-page, per-line text for identifying redaction targets.

Read-only: does not modify job state. ALWAYS call this before redact_by_text_range.
The returned 'text' field for each line is the source of truth — you MUST use it
to count exact character positions. Character positions within each line are 0-based
from the start of that line.

Input parameters:

- `job_id` (string, required): Job ID of the PDF to inspect (use the latest job_id).
- `session_id` (string, required): Session ID that the job belongs to.

Output parameters:

- `pages` (array)

### `redact_by_text_range` (~506 tokens)

Redact PDF Text

Redact PDF text by specifying the exact text to remove on each line.

MANDATORY WORKFLOW — follow every step in order before calling this tool:

Step 1 — Retrieve line text:
    Call list_redactable_line_text and note the exact 'text' string
    and 'line_index' for every line you intend to redact.

Step 2 — Identify the text to redact:
    Provide the exact substring to remove. The value must appear verbatim
    in the line's 'text' field.
    - Non-CJK text (e.g. English): whole-word matching is enforced.
      "the" will NOT redact text inside "then", "there", or "either".
    - CJK text (e.g. Chinese): substring matching — "王大明" will match
      wherever it appears in the line.

Step 3 — Build the content payload:
    Group redaction targets by page. Each page entry contains a list of
    { line_index, text } pairs.

    Example:
        content = [
            {
                "page_index": 1,
                "lines": [
                    {"line_index": 3, "text": "John Doe"},
                    {"line_index": 7, "text": "confidential"}
                ]
            }
        ]

Step 4 — Verify and re-redact if needed:
    After this tool returns, you MUST call list_redactable_line_text again
    with the NEW job_id to verify that all intended targets have been removed.
    If any target text still appears in the result, call redact_by_text_range
    again immediately with the remaining targets. Repeat until all targets
    are gone — do NOT report success until the verification confirms zero
    remaining targets.

Creates a NEW job_id (with parent_job_id linking to the source). After redaction
completes, call 'view_pdf' with the new job_id to display the result.

Input parameters:

- `content` (array, required): List of pages to redact. Each item must include: - page_index (int): 1-based page number. - lines (list): each entry contains:     - line_index (int): line index from list_redactable_line_text.     -…
- `job_id` (string, required): Job ID of the PDF to redact (use the latest job_id).
- `session_id` (string, required): Session ID that the job belongs to.

Output parameters:

- `download_url` (string)
- `filename` (string)
- `instructions` (string)
- `job_id` (string)
- `mime_type` (string)
- `parent_job_id`
- `reply_note` (string)
- `session_id` (string)

### `upload_pdf` (~244 tokens)

Upload PDF

Upload a PDF from a ChatGPT file attachment (download URL).

MANDATORY WORKFLOW — follow EVERY step in order:
1\. ALWAYS call check_upload_status FIRST — even if you think the file is new.
2\. If a job with the same filename already exists, reuse its job_id — do NOT call upload_pdf.
3\. Only call upload_pdf if the file is confirmed absent from check_upload_status.
Skipping step 1 and calling upload_pdf directly is FORBIDDEN.

Use this when the user provides a file attachment in ChatGPT. The tool downloads
the PDF from the signed URL in the pdf_file parameter and stores it immediately.
Returns session_id and job_id for use in all subsequent tool calls.

For MCP clients where no file attachment is available (e.g. Claude), use
create_upload_page instead to display an upload widget.

Input parameters:

- `pdf_file` (required): File object from ChatGPT containing download_url (and optionally name/filename). Passed automatically from the file attachment.
- `session_id`: Existing session ID to group this file with previous uploads. If omitted, a new session is created. Always pass the same session_id throughout the entire conversation.

### `batch_upload_pdf` (~223 tokens)

Batch Upload PDFs

Upload multiple PDF files from ChatGPT file attachments (download URLs).

Use this when the user provides multiple file attachments in ChatGPT.
Downloads each PDF from its signed URL and stores it.
Returns session_id and a list of job_ids.

MANDATORY WORKFLOW before calling this tool:
1\. ALWAYS call check_upload_status FIRST — even if you think the files are new.
2\. Only include files confirmed absent from check_upload_status. If ALL files are already
   uploaded, skip batch_upload_pdf entirely and reuse the existing job_ids.
3\. Reuse job_ids from already_uploaded — do NOT re-upload those files.
Skipping step 1 and calling batch_upload_pdf directly is FORBIDDEN.

After batch_upload_pdf completes: if the user requested a comparison, call
'compare_pdfs' with the returned job_ids immediately.

Input parameters:

- `pdf_files` (array, required): List of file objects from ChatGPT, each containing download_url (and optionally name/filename).
- `session_id`: Existing session ID to group these files. If omitted, a new session is created.

Output parameters:

- `file_count` (integer)
- `instructions` (string)
- `jobs` (array)
- `reply_note` (string)
- `session_id` (string)

### `create_upload_page` (~207 tokens)

Create PDF Upload Page

Display an interactive PDF upload widget directly in the chat.

Use this when the user wants to upload a local PDF file from their device.
This is the standard upload method for MCP clients (e.g. Claude) where
file attachments with download URLs are not available.

Do NOT call upload_pdf when using this tool — the widget handles the upload automatically.
The widget renders inline and the PDF viewer appears after the user selects a file.
Do NOT call view_pdf after this tool; the widget manages the UI.
Never tell the user the file is still uploading; the widget handles the spinner.

After the user uploads via the widget and notifies you, call
check_upload_status(session_id=<session_id>) to discover the uploaded file
and its job_id before proceeding with any operation.

Input parameters:

- `session_id`: Existing session ID to continue an ongoing workflow. If omitted, a new session is created. Always pass the same session_id throughout the entire conversation to keep all files grouped together.

Output parameters:

- `instructions` (string)
- `job_id` (string)
- `reply_note` (string)
- `session_id` (string)
- `upload_token` (string)
- `upload_url` (string)

### `check_upload_status` (~280 tokens)

Check Upload Status

Check existing uploads and determine which files still need uploading.

Call this BEFORE upload_pdf or create_upload_page to avoid duplicate uploads.
Also call it after the user uploads via the widget to discover the new file
and its job_id.

Returns 'session_id' (always — store it!), plus:
\- 'already_uploaded': files found in this session with reusable job_ids
\- 'needs_upload': files not yet in this session (must be uploaded)

You MUST call this tool before any upload, and you MUST act on its result immediately:
\- 'needs_upload' is non-empty → call upload_pdf (single) or batch_upload_pdf (multiple)
  with ONLY the files listed in 'needs_upload'. Pass the same session_id.
  Do NOT upload files in 'already_uploaded'.
\- 'needs_upload' is empty → skip uploading entirely; use the job_ids from 'already_uploaded'.

When pending_filenames is omitted, returns all jobs currently in the session.

Input parameters:

- `pending_filenames`: Bare filenames to check, e.g. ['FileA.pdf', 'FileB.pdf']. Never include directory paths like '/mnt/data/FileA.pdf'.
- `session_id`: Session ID from a previous upload_pdf or create_upload_page call. If omitted, a new session_id is generated and ALL pending files are treated as needs_upload (new workflow).

### `view_pdf` (~178 tokens)

View PDF

Display an already-uploaded PDF in an interactive viewer widget.

Call this after delete_pdf_page, set_password, change_password, redact_pii, and
redact_by_text_range to show the updated PDF. Also call when the user explicitly
asks to (re-)display a specific PDF.
Do NOT call this after upload_pdf (the widget handles it automatically).
Before calling, confirm the job_id exists via check_upload_status.

MANDATORY after this tool returns:
1\. Render a markdown download link so the user can save the file:
   [Download {filename}]({download_url})
2\. Follow cta_instruction and append cta_text at the end of your reply.

Input parameters:

- `job_id` (string): Job ID of the PDF to display (use the latest job_id).
- `session_id`: Session ID that the job belongs to.

Output parameters:

- `cta_instruction` (string)
- `cta_text` (string)
- `download_url` (string)
- `filename` (string)
- `instructions` (string)
- `job_id` (string)
- `pdf_url` (string)
- `reply_note` (string)
- `session_id` (string)
- `status` (string)

### `get_pdf_status` (~51 tokens)

Get PDF Status

Return current status of a PDF viewer job. Used internally by the viewer widget.

Input parameters:

- `job_id` (string): Job ID of the PDF to check.
- `session_id`: Session ID of the job.

Output parameters:

- `filename` (string)
- `job_id` (string)
- `pdf_url` (string)
- `session_id` (string)
- `session_status` (string)
- `status` (string)

### `get_pdf_info` (~105 tokens)

Get PDF Info

Use this when you need to read the text content of each page to decide which pages to delete. Returns page count and a text preview of every page. Use for text-based identification: table of contents, blank pages, cover page, etc. For visual content (logos, images, photos), use get_pdf_page_images instead.

Input parameters:

- `job_id` (string, required): Job ID of the PDF to inspect.
- `session_id` (string, required): Session ID that the job belongs to.

### `get_pdf_page_images` (~218 tokens)

Get PDF Page Images

Use this when you need to visually inspect PDF pages to identify content that cannot be detected from text alone — for example, pages containing a logo, a photograph, a watermark, a QR code, or any visual element. Returns rendered JPEG screenshots as images you can see. Returns at most 10 pages per call. ALWAYS start from start_page=1 and paginate through the ENTIRE document: check 'has_more' in structuredContent — if true, call again with start_page=next_start_page. Repeat until has_more is false. You must finish scanning all pages before answering the user's question or performing any action (e.g. deletion). Requires: pip install pymupdf

Input parameters:

- `count` (integer): Number of pages to render per call (capped at MAX_IMAGE_PAGES).
- `job_id` (string, required): Job ID of the PDF to render.
- `session_id` (string, required): Session ID that the job belongs to.
- `start_page` (integer): 1-based page number to start from (default 1).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-kdandoc-mcp-kdan-pdf-mcp/mcp#diagnostics

## Score history

- 2026-08-03: 61
- 2026-08-02: 61
- 2026-08-01: 60
- 2026-07-31: 59
- 2026-07-30: 59
- 2026-07-29: 58
- 2026-07-28: 57

## Links

- Remote endpoint: https://mcp.kdandoc.com/mcp
- Repository: https://github.com/KDAN-PDF/KDAN-PDF-MCP
- Website: https://pdf-reader.kdandoc.com/products/mcp/claude
- Changelog RSS feed: https://verifymcp.io/servers/com-kdandoc-mcp-kdan-pdf-mcp/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-kdandoc-mcp-kdan-pdf-mcp/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-kdandoc-mcp-kdan-pdf-mcp/mcp