English Français العربية

PDF to Markdown

Official registry Productivity

Hosted MCP front door to the pdf2md API: checked PDF-to-Markdown requests, short-lived credential.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http pdf-to-markdown 'https://pdf2md.dudko.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pdf-to-markdown": {
            "type": "http",
            "url": "https://pdf2md.dudko.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PDF to Markdown — MCP setup
  2. What you can do
  3. Install in Claude Code (plugin)
  4. Connect from other clients
  5. Authentication
  6. Troubleshooting
  7. Support

PDF to Markdown — MCP setup

Connect your AI assistant to pdf2md — PDF to clean Markdown, tables and images included — through our hosted Model Context Protocol (MCP) server. Sign in once with your dudko.dev account; no API key to paste.

The server is the front door to the pdf2md HTTP API, not a converter: a document never travels through the model or through the server. The assistant asks for a request, and runs it wherever the PDF is.

  • Server: pdf-to-md
  • Transport: streamable HTTP
  • URL: https://pdf2md.dudko.dev/mcp
  • Auth: OAuth 2.1 via auth.dudko.dev — you'll be prompted to sign in.

What you can do

Two tools, both free:

ToolWhat it does
api_accessHow the pdf2md API works: endpoints, options, limits, errors.
api_requestChecks conversion options (convert, detect, text) and returns the exact request — URL, headers, a curl command — with a 15-minute credential for your account.

Install in Claude Code (plugin)

/plugin marketplace add dudko-dev/pdf-to-md-mcp-setup
/plugin install pdf-to-md@pdf-to-md
/reload-plugins

Then run /mcp and complete the sign-in when prompted.

Prefer not to use the marketplace? Add the server directly:

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

Connect from other clients

Same remote URL, same sign-in — only the config location differs.

Claude Desktop / claude.ai connectors
  1. Open Settings → Connectors → Add custom connector.
  2. Name: PDF to Markdown
  3. URL: https://pdf2md.dudko.dev/mcp
  4. Save, then connect and sign in when prompted.
Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{
  "mcpServers": {
    "pdf-to-md": {
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}
VS Code (GitHub Copilot / MCP) and other clients
{
  "servers": {
    "pdf-to-md": {
      "type": "http",
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

Authentication

The server is an OAuth 2.1 resource server. The first call answers 401 with a WWW-Authenticate header pointing at its protected-resource metadata:

  • https://pdf2md.dudko.dev/.well-known/oauth-protected-resource/mcp

which names https://auth.dudko.dev as the authorization server (scope usage). Compliant MCP clients discover this automatically — you only need the server URL, and you sign in with your dudko.dev account. Tokens are audience-bound to https://pdf2md.dudko.dev/mcp and are refused anywhere else.

The server itself carries no files and no content: its tools return a ready-to-run HTTP request with a short-lived credential (15 minutes, good for this API only) for the account you signed in as. Your assistant runs that request wherever the file is, and the API answers the caller directly. Each request counts against your account's plan like any other API call; the MCP tools themselves are free.

Troubleshooting

  • 401 / asked to sign in again — the token expired; reconnect in the client.
  • "plan used up" / 402 — the conversion quota for your account is spent; retrying will not help. See https://auth.dudko.dev/account.
  • 422 from /convert — the PDF is a scan with no text layer. pdf2md does no OCR; detect tells you this before you spend a conversion.
  • Tools don't appear — check the client finished the sign-in (/mcp in Claude Code shows connected).

Support

Frequently asked questions

What is PDF to Markdown?

Hosted MCP front door to the pdf2md API: checked PDF-to-Markdown requests, short-lived credential.

How do I install PDF to Markdown?

It runs as a remote server. In Claude Code: claude mcp add --transport http pdf-to-markdown 'https://pdf2md.dudko.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does PDF to Markdown need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is PDF to Markdown open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains PDF to Markdown?

It is published by dudko-dev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.