@sheetrender/mcp

Servidor MCP para SheetRender — da a tu asistente de IA la capacidad de renderizar PDFs a partir de plantillas HTML y datos de hojas de cálculo.

Configuración

Obtén una clave de API en sheetrender.com → Ajustes → Claves de API, y luego añádela a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "sheetrender": {
      "command": "npx",
      "args": ["-y", "@sheetrender/mcp"],
      "env": { "SHEETRENDER_API_KEY": "sr_live_..." }
    }
  }
}

SHEETRENDER_API_URL también se lee, con valor predeterminado https://sheetrender.com. Ajústala solo para apuntar a una instancia autoalojada o de staging.

Related MCP server: Dokmatiq DocGen

Herramientas

render_pdf

Renderiza un PDF a partir del HTML que proporciones.

Devuelve la ruta del PDF guardado y su tamaño. Si es inferior a 512 KB, también se adjunta en línea como recurso base64, de modo que los clientes que muestran adjuntos presentan el documento en sí.

Se aplican dos límites del servidor. Se rechaza el HTML de más de 2 MB, medido tanto en lo que envías como en el documento después de sustituir data, por lo que una plantilla que expande un conjunto de datos largo puede superar el límite incluso cuando el marcado que escribiste no lo hace. Y en el plan gratuito, cada PDF renderizado lleva un pie de página "Hecho con SheetRender", tanto desde render_pdf como desde render_template; los planes de pago no lo llevan.

list_templates

Sin argumentos. Devuelve el nombre, el id y la fecha de última actualización de cada plantilla guardada. Llámalo para convertir un nombre de plantilla que el usuario mencionó en el id que quieren las otras herramientas.

render_template

Renderiza un PDF a partir de una plantilla ya guardada en la cuenta.

Mismo retorno que render_pdf.

create_batch_job

Pone en cola un trabajo en segundo plano que renderiza un PDF por cada fila de un conjunto de datos ya subido al proyecto. Este servidor no puede subir hojas de cálculo.

Devuelve el id del trabajo para consultar con get_job. Ten en cuenta que filename_template y group_by se persisten en la plantilla y el proyecto respectivamente, por lo que también cambian los valores predeterminados para ejecuciones posteriores.

Si el servidor es anterior al endpoint público de lotes, la herramienta informa de que los trabajos por lotes no están disponibles en lugar de fallar de forma oscura.

get_job

Toma job_id. Devuelve el estado, las filas completadas y fallidas, y — una vez que el trabajo alcanza succeeded, partial, failed o cancelled — el id y el nombre de archivo de cada documento renderizado. La lista de documentos permanece vacía mientras el trabajo está queued, retry_queued o running. Esos ids de documento son los que toma get_document.

get_document

Toma document_id y descarga ese único PDF renderizado. Los ids provienen de get_job en un lote terminado; no hay otra forma de obtener uno. Mismo retorno que render_pdf — ruta, tamaño y un blob en línea inferior a 512 KB.

Para un lote completo, el PDF combinado y el ZIP en la aplicación web superan a descargar cada documento por separado.

page_settings

Compartido por ambas herramientas de renderizado, todos los campos son opcionales:

{
  "page_size": "a4",
  "orientation": "portrait",
  "margins": { "top": 15, "right": 15, "bottom": 15, "left": 15 }
}

page_size está en minúsculas — a3, a4, a5, letter, legal o tabloid. Los márgenes son números simples en milímetros, no longitudes CSS.

Los PDFs renderizados se escriben en el directorio temporal del sistema. Los errores de la API — una clave incorrecta, una plantilla inexistente, un límite de velocidad — vuelven como errores de herramienta con el mensaje propio del servidor.

La API pública permite 120 solicitudes por minuto por clave de API. Más allá de eso devuelve 429 y la herramienta informa de que estás limitado por velocidad y deberías reintentar en breve. La creación de trabajos por lotes se mide por separado y de forma más estricta.

Desarrollo

No se necesita node/npm en el host — scripts/dev.sh install, scripts/dev.sh deno task build.

Licencia MIT.