Skip to content

PDF to Markdown

by pdfmd.dev · remote · no sign-in to list tools · v1.0.1 · published by dev.pdfmd

Convert public PDF links into Markdown with page counts and explicit excerpt limits.

Changes · 1

1 tool: 1 change things.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http pdf-to-markdown https://pdfmd.dev/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "convert_pdf_url" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "convert_pdf_url" says "convert": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

1 tool

Changes things 1Claude Code: ask
  • convert_pdf_urlUse when someone asks to read, quote or summarize a PDF that sits at a public web link, or wants it as Markdown or HTML for research or a coding project.1 finding

    Why it is in this group

    • The name "convert_pdf_url" says "convert": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "convert_pdf_url" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The name "convert_pdf_url" says "convert": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Use when someone asks to read, quote or summarize a PDF that sits at a public web link, or wants it as Markdown or HTML for research or a coding project. Returns extracted text, page and table counts, and whether scanned pages were found. It does not OCR scanned pages and it cannot open private links or local files. The reply holds at most 20,000 Markdown characters and marks a longer result as an excerpt; the whole PDF counts toward the API page allowance.

    Annotations the server declares

    • title: Convert a public PDF to Markdown
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http pdf-to-markdown https://pdfmd.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [],
    "ask": [
      "mcp__pdf-to-markdown__convert_pdf_url"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as pdf-to-markdown. Review it before you use it.