# PDF to Markdown

> PDF to Markdown is a freemium MCP server for files and documents. Convert public PDF links to Markdown with page counts and excerpt limits. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $8.9 a month
- **Platforms:** Web, API
- **Website:** https://pdfmd.dev/docs
- **MCP Registry name:** dev.pdfmd/pdf-to-markdown
- **Categories:** files and documents
- **Listing updated:** 2026-11-16

## About

Page credits are the unit that matters here. Every converted page, text or scanned, costs one credit, and a conversion that fails is not charged on paid plans. Without a key you get 25 pages a day per IP, a free key for your email raises that to 50, and a paid plan raises the per-file cap to 400 pages. Free use is meant for personal projects or study.

The service behind the MCP endpoint is a REST API that returns JSON with the Markdown, the page count, table count, character offsets for page breaks and a list of warnings. The warnings flag values the parser could not settle, such as a footnote mark it could not place or a table number the page does not print. A separate OCR endpoint reads English scanned PDFs and can return Markdown or a searchable PDF.

The remote server is reached over streamable HTTP at pdfmd.dev/mcp. It suits assistants that need to read a public PDF link, for example a paper or a filing, and want a bounded excerpt instead of a raw file.

## Features

- **PDF links to Markdown:** Fetches a public PDF by URL and returns headings and GitHub-flavoured tables as Markdown.
- **Page and table counts:** Each result reports pages, scanned pages, tables, characters and parse time.
- **Parser warnings:** Flags unplaced footnote marks and table values the page does not print, so you can check them.
- **English OCR:** A separate endpoint reads scanned pages and returns Markdown or a searchable PDF.
- **HTML output:** The REST API can return an embeddable HTML fragment instead of Markdown.
- **Free tier without a key:** 25 pages a day per IP, 50 with a free key.

## Good for

- Let an assistant read a research paper from its PDF link
- Turn a scanned report into searchable text
- Feed contract or filing PDFs into a document pipeline
- Extract tables from PDFs as Markdown

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://pdfmd.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pdf-to-markdown": {
      "url": "https://pdfmd.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pdf-to-markdown": {
      "type": "http",
      "url": "https://pdfmd.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pdf-to-markdown": {
      "serverUrl": "https://pdfmd.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pdf-to-markdown": {
      "type": "http",
      "url": "https://pdfmd.dev/mcp"
    }
  }
}
```

## FAQ

### How many pages can I convert for free?

25 pages a day per IP with no key and 50 a day with a free key, up to 25 pages per file.

### What does the paid plan cost?

The Starter plan is $8.90 a month for 10,000 pages, and plans start from $0.75 per 1,000 pages.

### Can it read scanned PDFs?

Yes, English printed text only, through the OCR endpoint. Scanned pages cost the same one credit.

### Is commercial use allowed on the free tier?

No. Free use is for one person's own projects or studies; production, team and commercial use need a paid plan.

### Is PDF to Markdown free?

PDF to Markdown has a free plan, with paid plans for more usage or features. Paid plans start at $8.9 a month.

### How do I add PDF to Markdown to Claude Code?

Run this command in your terminal: claude mcp add --transport http pdf-to-markdown https://pdfmd.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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/pdf-to-markdown-2
