PDFtoMarkdown.ai MCP

Converta PDFs em Markdown limpo e estruturado a partir de qualquer cliente MCP. Com suporte da API PDFtoMarkdown.ai; plano gratuito mais créditos pagos por página, sem assinatura.

GitHub

Documentação

PDFtoMarkdown.ai — Servidor MCP

Um servidor MCP que permite que agentes de IA convertam PDFs, Word, PowerPoint, Excel, imagens, HTML e EPUB em Markdown limpo e estruturado — com tecnologia da PDFtoMarkdown.ai.

Dê ao Claude, Cursor, Codex, Hermes, OpenClaw ou qualquer cliente compatível com MCP uma ferramenta convert_pdf_to_markdown para que ele possa transformar documentos locais em Markdown pronto para agentes sob demanda — com cabeçalhos, tabelas e texto de OCR preservados — em vez de sofrer com blocos de documentos brutos.

Por quê

Modelos raciocinam muito melhor sobre Markdown limpo do que sobre layout bruto de PDF/Office. Converter um documento uma vez para Markdown é mais barato, mais rápido e com maior fidelidade do que fazer o modelo refazer o OCR a cada execução.

Recursos

🧠 Markdown pronto para agentes — cabeçalhos, listas e tabelas preservados
📄 Muitos formatos — PDF, DOCX, PPTX, XLSX, PNG/JPG, HTML, EPUB
🔍 OCR — lê PDFs escaneados e imagens (Force OCR opcional)
🔌 MCP plug-and-play — uma ferramenta, funciona em qualquer cliente MCP
⚡ Rápido — a maioria dos documentos converte em segundos

Pré-requisitos

Node.js 18+
Uma chave de API gratuita da sua conta PDFtoMarkdown.ai

Instalação

npm install -g @happywp/pdftomarkdown-mcp

Configuração

Adicione o servidor à configuração do seu cliente MCP, usando a chave de API da sua conta.

Claude Desktop — claude_desktop_config.json:

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

Cursor — ~/.cursor/mcp.json usa o mesmo formato mcpServers.

Codex — ~/.codex/config.toml:

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

Reinicie o cliente para que o servidor seja carregado.

Uso

Basta pedir ao seu agente:

Converta este PDF para Markdown e resuma os pontos principais: /path/to/document.pdf

Ferramenta

`convert_pdf_to_markdown`

Argumento	Tipo	Obrigatório	Descrição
`file_path`	string	sim	Caminho absoluto do documento a ser convertido
`force_ocr`	boolean	não	Força OCR em todas as páginas (para arquivos escaneados)

Retorna o Markdown convertido, o número de páginas e os créditos usados.

Variáveis de ambiente

Variável	Descrição
`PDFTOMARKDOWN_API_KEY`	Sua chave de API da PDFtoMarkdown.ai (obtenha uma gratuitamente)

Preços

Pague por página — sem assinatura. Comece gratuitamente (10 páginas grátis com uma conta, sem necessidade de cartão). Veja pdftomarkdown.ai/pricing.