PDF to Markdown — Claude Code MCP server: install
This MCP server connects an AI agent to the pdf2md API and prepares requests to turn PDFs into Markdown. Sign in with a dudko.dev account to use it.
claude mcp add --transport http pdf-to-md https://pdf2md.dudko.dev/mcpWhat PDF to Markdown does
The server provides two tools. api_access explains the API, its options and limits; api_request checks conversion settings and returns an HTTP request with a URL, headers and a curl command. The server does not handle the PDF itself: the request runs wherever the file is stored.
Connection uses OAuth 2.1, and the client prompts you to sign in to your dudko.dev account. API credentials last 15 minutes, and requests count toward the account plan. Scanned PDFs without a text layer cannot be converted because pdf2md does not perform OCR. Use detect to check the document first.
What it helps with
- prepare an HTTP request to convert a PDF to Markdown
- check pdf2md API options and limits
- find out whether a scanned PDF has a text layer
Example prompts for the agent
- Prepare a request to convert
report.pdfto Markdown. - Show me the API options for extracting text from a PDF.
- Check whether
scan.pdfhas a text layer before conversion.
How to install PDF to Markdown
Platform CLI: remote server
claude mcp add --transport http pdf-to-md https://pdf2md.dudko.dev/mcpPlatform CLI: remote server
codex mcp add pdf-to-markdown --url https://pdf2md.dudko.dev/mcpConfig file
{
"mcpServers": {
"pdf-to-markdown": {
"url": "https://pdf2md.dudko.dev/mcp"
}
}
}Config file
{
"servers": {
"pdf-to-markdown": {
"type": "http",
"url": "https://pdf2md.dudko.dev/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http pdf-to-markdown https://pdf2md.dudko.dev/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PDF to Markdown
How do I install PDF to Markdown in Claude Code?
Run claude mcp add --transport http pdf-to-md https://pdf2md.dudko.dev/mcp, then sign in to your dudko.dev account when prompted.
What does PDF to Markdown do?
It connects an agent to the pdf2md API. Its tools explain the API and prepare a checked HTTP request for a conversion.
Can PDF to Markdown handle scanned PDFs without a text layer?
No. pdf2md does not run OCR. Use detect to check for a text layer before requesting a conversion.
