PDFtoMarkdown.ai MCP

Convierte PDFs en Markdown limpio y estructurado desde cualquier cliente MCP. Respaldado por la API de PDFtoMarkdown.ai; plan gratuito más créditos de pago por página, sin suscripción.

GitHub

Documentación

PDFtoMarkdown.ai — Servidor MCP

Un servidor MCP que permite a los agentes de IA convertir PDF, Word, PowerPoint, Excel, imágenes, HTML y EPUB en Markdown limpio y estructurado — impulsado por PDFtoMarkdown.ai.

Dale a Claude, Cursor, Codex, Hermes, OpenClaw o cualquier cliente compatible con MCP una herramienta convert_pdf_to_markdown para que pueda convertir documentos locales en Markdown listo para agentes bajo demanda — con encabezados, tablas y texto OCR preservados — en lugar de atragantarse con blobs de documentos sin procesar.

Por qué

Los modelos razonan mucho mejor sobre Markdown limpio que sobre el diseño sin procesar de PDF/Office. Convertir un documento una vez a Markdown es más barato, más rápido y de mayor fidelidad que hacer que el modelo vuelva a aplicar OCR en cada ejecución.

Características

🧠 Markdown listo para agentes — encabezados, listas y tablas preservados
📄 Muchos formatos — PDF, DOCX, PPTX, XLSX, PNG/JPG, HTML, EPUB
🔍 OCR — lee PDFs escaneados e imágenes (OCR forzado opcional)
🔌 MCP integrable — una herramienta, funciona en cualquier cliente MCP
⚡ Rápido — la mayoría de los documentos se convierten en segundos

Requisitos previos

Node.js 18+
Una clave API gratuita desde tu cuenta de PDFtoMarkdown.ai

Instalación

npm install -g @happywp/pdftomarkdown-mcp

Configuración

Añade el servidor a la configuración de tu cliente MCP, usando la clave API de tu cuenta.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "pdftomarkdown": {
      "command": "pdftomarkdown-mcp",
      "env": {
        "PDFTOMARKDOWN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor — ~/.cursor/mcp.json usa la misma forma de mcpServers.

Codex — ~/.codex/config.toml:

[mcp_servers.pdftomarkdown]
command = "pdftomarkdown-mcp"
env = { PDFTOMARKDOWN_API_KEY = "your-api-key-here" }

Reinicia tu cliente para que el servidor se cargue.

Uso

Solo pregúntale a tu agente:

Convierte este PDF a Markdown y resume los puntos clave: /path/to/document.pdf

Herramienta

`convert_pdf_to_markdown`

Argumento	Tipo	Requerido	Descripción
`file_path`	string	sí	Ruta absoluta al documento a convertir
`force_ocr`	boolean	no	Forzar OCR en cada página (para archivos escaneados)

Devuelve el Markdown convertido, el número de páginas y los créditos utilizados.

Variables de entorno

Variable	Descripción
`PDFTOMARKDOWN_API_KEY`	Tu clave API de PDFtoMarkdown.ai (obtén una gratis)

Precios

Paga por página — sin suscripción. Comienza gratis (10 páginas gratuitas con una cuenta, sin necesidad de tarjeta). Consulta pdftomarkdown.ai/pricing.