RelayPDF

Genera, convierte, edita y extrae PDFs desde clientes MCP. RelayPDF es un servidor MCP de PDF y documentos. Genera PDFs a partir de HTML, URLs, Markdown y plantillas, convierte archivos de Office, imágenes y correos electrónicos, y edita PDFs (fusionar, dividir, rellenar, proteger, optimizar). Extrae texto OCR y JSON. Alojado en https://api.relaypdf.com/mcp o localmente mediante npx @relaypdf/cli mcp.

Ver en relaypdf.com

Servidor MCP alojado

npx add-mcp 'https://api.relaypdf.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Use POST https://api.relaypdf.com/mcp cuando el host necesite una URL pública (Claude, Relevance, Cursor remoto). Usa npx @relaypdf/cli mcp en una laptop después de la configuración de relaypdf. Los agentes nunca deben pedirle a un humano que pegue una clave API en el chat.

Dos transportes, mismas herramientas. MCP alojado es Streamable HTTP con OAuth de Clerk (inicio de sesión en navegador) o una clave API Bearer. MCP Stdio es para Cursor/Claude Desktop local después de la configuración de relaypdf. Las herramientas de generación en el servidor alojado devuelven una URL de 24 horas — no rutas de sistema de archivos ni bytes crudos.

Alojado (Streamable HTTP)

POST https://api.relaypdf.com/mcp. Las solicitudes no autenticadas devuelven 401 con WWW-Authenticate resource_metadata. Cursor y Claude completan entonces el inicio de sesión de Clerk. Las entradas de archivo son URLs https o archivo base64. Prefiere la url de una herramienta anterior como la siguiente entrada. async: true devuelve un id de trabajo; consulta con jobs_get o jobs_wait.

Claude Code

claude mcp add --transport http relaypdf https://api.relaypdf.com/mcp

Cursor / JSON (remoto)

Solo URL. El host almacena el token OAuth después de Allow. No pongas una clave en el prompt. Los encabezados Bearer aún funcionan para hosts que ya tienen una clave.

mcp.json

{
  "mcpServers": {
    "relaypdf": {
      "url": "https://api.relaypdf.com/mcp"
    }
  }
}

Clave API Bearer (opcional)

Los scripts y hosts que no pueden ejecutar OAuth pueden enviar Authorization: Bearer pdf_live_…. Almacena la clave en el mapeo de encabezados o entorno del host — no en el chat.

mcp.json

{
  "mcpServers": {
    "relaypdf": {
      "url": "https://api.relaypdf.com/mcp",
      "headers": {
        "Authorization": "Bearer pdf_live_…"
      }
    }
  }
}

Stdio (CLI local)

Usa las mismas credenciales locales que los comandos CLI (~/.config/relaypdf/credentials.json o RELAYPDF_API_KEY). Las herramientas binarias requieren out (una ruta de sistema de archivos).

Inicio

npx @relaypdf/cli mcp

Ejemplo de Cursor (stdio)

Apunta una entrada de servidor MCP a npx después de la configuración de relaypdf.

mcp.json

{
  "mcpServers": {
    "relaypdf": {
      "command": "npx",
      "args": ["-y", "@relaypdf/cli", "mcp"]
    }
  }
}