Skip to content
MCP server

PDF to Markdown

Hosted MCP gateway that sets up PDF-to-Markdown conversion requests

Install
Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

About PDF to Markdown

PDF to Markdown is a freemium MCP server for files and documents. It runs as a hosted remote server, so there is nothing to install locally.

The server itself never touches a document. It acts as a front door to the pdf2md HTTP API: the assistant asks it for a checked request, and then runs that request wherever the PDF actually sits, so files do not pass through the model or the MCP server.

Two tools are exposed. One explains how the API works (endpoints, options, limits, errors); the other validates conversion options for the convert, detect and text endpoints and returns a ready-to-run URL, headers and curl command carrying a credential that lasts 15 minutes. Sign-in uses OAuth 2.1 with a dudko.dev account, so there is no API key to paste.

Conversions count against the account's plan like any other API call, while the MCP tools themselves are free. The README notes that scanned PDFs with no text layer are rejected with a 422 because pdf2md does no OCR, and that the detect endpoint can tell you this before a conversion is spent.

Install

Run in a terminal

claude mcp add --transport http pdf-to-md https://pdf2md.dudko.dev/mcp

Add to Settings → Connectors → Add custom connector

https://pdf2md.dudko.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdf-to-md": {
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pdf-to-md": {
      "type": "http",
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdf-to-md": {
      "serverUrl": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pdf-to-md": {
      "type": "http",
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

api_access
Explains how the pdf2md API works: endpoints, options, limits and errors.
api_request
Checks conversion options and returns the exact request with a 15-minute credential.

What it does

Request builder
Validates conversion options and returns the exact URL, headers and curl command to run.
API guide tool
Explains endpoints, options, limits and error codes of the pdf2md API.
Short-lived credential
Each request carries a credential valid for 15 minutes, for this API only.
OAuth 2.1 sign-in
Authenticates with a dudko.dev account; tokens are bound to the server URL.
Scan detection
The detect option reveals scanned PDFs before a conversion is used.

Good for

  • Convert a local PDF to Markdown from inside an AI assistant
  • Check whether a PDF has a text layer before spending a conversion
  • Get a curl command for batch PDF conversion in a script
  • Prepare PDF text for use in LLM prompts

Pricing

Freemium

MCP tools are free; conversions count against the account plan. A few files are free without an account on the website.

Prices change. Check pdf2md.dudko.dev before you buy.

PDF to Markdown FAQ

Does the PDF go through the MCP server?

No. The server only returns a ready-to-run request; the assistant runs it wherever the file is, and the API answers the caller directly.

Does it handle scanned PDFs?

No. A scan without a text layer returns a 422, since pdf2md does no OCR; the detect option flags this beforehand.

How do I connect it?

Add https://pdf2md.dudko.dev/mcp as a streamable HTTP server, or install the Claude Code plugin from the dudko-dev marketplace, then sign in when prompted.

Are the MCP tools free?

Yes, both tools are free, but each conversion request counts against your account's plan.

Is PDF to Markdown free?

PDF to Markdown has a free plan, with paid plans for more usage or features.

How do I add PDF to Markdown to Claude Code?

Run this command in your terminal: claude mcp add --transport http pdf-to-md https://pdf2md.dudko.dev/mcp

What are the best alternatives to PDF to Markdown?

The closest alternatives to PDF to Markdown are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to PDF to Markdown

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media