PDFMakerAPI

Servidor MCP de PDFMakerAPI

Un servidor MCP para PDFMakerAPI. Expone una única herramienta create_document que convierte una descripción de documento en lenguaje natural en un enlace compartible que se abre en el editor de PDFMakerAPI: previsualízalo, edita cualquier campo y descarga el PDF.

Funciona con Claude Desktop, Claude.ai, Cursor, Windsurf, Cline, Zed, VS Code, ChatGPT y cualquier otro cliente MCP. Es un cliente ligero de la API pública en https://api.pdfmakerapi.com, por lo que no necesita cuenta ni credenciales propias.

¿Qué es PDFMakerAPI?

PDFMakerAPI es un constructor de plantillas PDF y una API de generación de PDF. En lugar de codificar documentos a mano o lidiar con convertidores de HTML a PDF que se rompen cuando tu contenido cambia, diseñas una plantilla reutilizable una sola vez en un editor visual sin código — colocando texto, tablas, imágenes y campos dinámicos exactamente donde los necesitas — y luego le suministras datos para producir un PDF final editable.

Genera un solo documento o miles. Completa una plantilla tú mismo, comparte un enlace para que cualquiera la complete en el navegador como un formulario PDF rellenable, envía JSON a la API REST, dispara la generación desde herramientas sin código como Zapier, Make y n8n, o crea documentos directamente desde agentes de IA como Claude y ChatGPT. ¿Prefieres empezar desde un prompt? Describe lo que necesitas y deja que Quill lo construya.

Los equipos usan PDFMakerAPI para facturas, recibos, certificados, informes y contratos — cualquier cosa que de otro modo tendrías que reconstruir manualmente cada vez que los datos cambian. Empieza a crear gratis con 100 PDFs al mes.

Instalación rápida

Un clic:

O añade la misma configuración manualmente (funciona en todos los clientes de escritorio):

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

Configuración por cliente

{
  "servers": {
    "pdfmakerapi": { "command": "npx", "args": ["-y", "@pdfmakerapi/mcp"] }
  }
}

{
  "context_servers": {
    "pdfmakerapi": { "command": { "path": "npx", "args": ["-y", "@pdfmakerapi/mcp"] } }
  }
}

Opción alojada (remota) — sin instalación

Si tu cliente admite servidores MCP remotos, solo apunta al endpoint alojado — sin npx, sin Node:

https://api.pdfmakerapi.com/mcp

• Claude.ai (web): Configuración → Conectores → Añadir conector personalizado → pega la URL.
• ChatGPT (Plus/Pro/Empresa): Configuración → Conectores → añade la URL.
• Cursor / otros: añade { "url": "https://api.pdfmakerapi.com/mcp" } en lugar de command/args.

Uso

Pídele a tu asistente un documento:

"Haz una factura profesional para Acme con 3 líneas de detalle." "Crea un certificado de finalización de curso." "Construye un currículum limpio de una página."

Llamará a create_document y devolverá un enlace como https://app.pdfmakerapi.com/d/<id> — ábrelo para previsualizar, editar cualquier campo y descargar el PDF.

Configuración

Desarrollo

git clone https://github.com/GerardoBarrera/pdfmakerapi-mcp.git
cd pdfmakerapi-mcp
npm install
npm run build   # compile to dist/
npm run dev     # run from source (tsx)

Solución de problemas

• El servidor no aparece en tu cliente — reinicia el cliente después de editar su configuración MCP y verifica que el JSON sea válido (sin comas finales). Para clientes remotos, confirma que la URL sea exactamente https://api.pdfmakerapi.com/mcp.
• npx no se inicia — asegúrate de que Node.js 18+ esté instalado (node -v), luego vuelve a intentar npx -y @pdfmakerapi/mcp@latest.
• Conexión / tiempo de espera en el endpoint remoto — verifica que tu red/proxy permita HTTPS a api.pdfmakerapi.com y que estés usando el transporte Streamable HTTP.
• "El documento es demasiado grande" — los documentos tienen un límite de ~1 MB de JSON; recorta tablas grandes o divide en varios documentos.
• El enlace devuelto no se abre — copia el enlace completo (termina en un ID de documento); si da 404, genera el documento nuevamente.
• ¿Sigue sin funcionar? — abre un problema en GitHub o escribe a support@pdfmakerapi.com.

Licencia

MIT