PDF to MD

npx add-mcp 'https://pdf-to-md.app/mcp'

API and MCP for document conversion

Run PDF, DOCX, image, HTML and Markdown-to-PDF conversions from scripts and AI tools with the same account credits.

REST flow

Upload a file as multipart form data, create a conversion with the returned uploadId, poll the job, then fetch Markdown, attachments or PDF output.

PDFTOMD_BASE_URL=https://your-domain.com
UPLOAD_ID=$(curl -sS -X POST "$PDFTOMD_BASE_URL/api/v1/uploads"   -H "Authorization: Bearer $PDFTOMD_API_KEY"   -F "file=@ordinary-en.pdf" | jq -r .id)

curl -sS -X POST "$PDFTOMD_BASE_URL/api/v1/conversions"   -H "Authorization: Bearer $PDFTOMD_API_KEY"   -H "Content-Type: application/json"   -H "Idempotency-Key: convert-ordinary-en-001"   -d '{"uploadId":"'"$UPLOAD_ID"'","mode":"standard"}'

Usage and credits

The API returns standard conversion quota, OCR pages and PDF export quota so clients can decide before starting a job.

curl -sS "$PDFTOMD_BASE_URL/api/v1/usage"   -H "Authorization: Bearer $PDFTOMD_API_KEY"

Remote MCP and client examples

MCP runs at /mcp over Streamable HTTP. It accepts uploaded file IDs or checked public HTTPS URLs, then returns large results as downloadable resources. Use the example clients as a starting point for scripts and agent tools.

{
  "mcpServers": {
    "pdf-to-md": {
      "url": "https://your-domain.com/mcp",
      "headers": {
        "Authorization": "Bearer $PDFTOMD_API_KEY"
      }
    }
  }
}