Generate PDFs and images from HTML, Markdown, URLs or JSON templates.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer token: your PDFOven API key, e.g. 'Bearer po_live_...'
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Make a PDF smaller by recompressing and downscaling large images and cleaning unused data. Returns the original unchanged if it can't be made smaller. Uses one render.
The PDF to compress.
low keeps the most quality; high makes the smallest file. Default medium.
Also strip title, author and XMP metadata.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Make a PDF smaller by recompressing and downscaling large images and cleaning unused data. Returns the original unchanged if it can't be made smaller. Uses one render.
| Argument | Type | Description |
|---|---|---|
| file* | object | The PDF to compress. |
| level | string | low keeps the most quality; high makes the smallest file. Default medium. |
| remove_metadata | boolean | Also strip title, author and XMP metadata. |
{
"type": "object",
"required": [
"file"
],
"properties": {
"file": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) URL of the PDF."
},
"base64": {
"type": "string",
"description": "The PDF as base64. Use url instead for files over a few MB."
},
"password": {
"type": "string",
"description": "Password, if the PDF is protected."
}
},
"description": "The PDF to compress."
},
"level": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"description": "low keeps the most quality; high makes the smallest file. Default medium."
},
"remove_metadata": {
"type": "boolean",
"description": "Also strip title, author and XMP metadata."
}
}
}Save a new reusable template to the account and return its id. Templates are capped per plan (Free 3); at the cap this returns a tool error. Render it later with render_pdf or render_image and template_id plus data.
| Argument | Type | Description |
|---|---|---|
| css | string | CSS applied when the template renders. |
| name* | string | Display name, 1-100 characters. |
| engine | string | How content is interpreted. Default handlebars. |
| content* | string | Template body: Handlebars HTML ({{field}}, {{#each items}}) or Markdown. |
| sample_data | object | Example JSON data, used for previews and as documentation of the fields. |
| page_options | object | Default PDF page settings for this template. |
{
"type": "object",
"required": [
"name",
"content"
],
"properties": {
"css": {
"type": "string",
"description": "CSS applied when the template renders."
},
"name": {
"type": "string",
"description": "Display name, 1-100 characters."
},
"engine": {
"enum": [
"handlebars",
"markdown"
],
"type": "string",
"description": "How content is interpreted. Default handlebars."
},
"content": {
"type": "string",
"description": "Template body: Handlebars HTML ({{field}}, {{#each items}}) or Markdown."
},
"sample_data": {
"type": "object",
"description": "Example JSON data, used for previews and as documentation of the fields."
},
"page_options": {
"type": "object",
"properties": {
"format": {
"enum": [
"A3",
"A4",
"A5",
"Letter",
"Legal",
"Tabloid"
],
"type": "string"
},
"margin": {
"type": "string",
"description": "e.g. 0.5in, 12mm, 20px"
},
"landscape": {
"type": "boolean"
},
"printBackground": {
"type": "boolean"
}
},
"description": "Default PDF page settings for this template."
}
}
}Permanently delete a saved template. This cannot be undone, and renders that reference its template_id will fail afterwards. Confirm with the user first.
| Argument | Type | Description |
|---|---|---|
| template_id* | string | Template ID, e.g. tpl_1a2b3c (from list_templates). |
{
"type": "object",
"required": [
"template_id"
],
"properties": {
"template_id": {
"type": "string",
"description": "Template ID, e.g. tpl_1a2b3c (from list_templates)."
}
}
}Fill a PDF form's fields by name (text, checkboxes as true/false, radio and dropdown options) and optionally flatten it so it can't be edited. Unknown field names are an error with suggestions. Uses one render.
| Argument | Type | Description |
|---|---|---|
| file* | object | The PDF form. |
| fields* | object | Field name to value: string, number, boolean, or a list for multi-select fields. |
| strict | boolean | Default true. False skips unknown field names. |
| flatten | boolean | Make the filled form read-only. |
{
"type": "object",
"required": [
"file",
"fields"
],
"properties": {
"file": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) URL of the PDF."
},
"base64": {
"type": "string",
"description": "The PDF as base64. Use url instead for files over a few MB."
},
"password": {
"type": "string",
"description": "Password, if the PDF is protected."
}
},
"description": "The PDF form."
},
"fields": {
"type": "object",
"description": "Field name to value: string, number, boolean, or a list for multi-select fields."
},
"strict": {
"type": "boolean",
"description": "Default true. False skips unknown field names."
},
"flatten": {
"type": "boolean",
"description": "Make the filled form read-only."
}
}
}Fetch one saved template in full: content, css, sample_data and page_options. Use it before update_template to see the current body. Does not use render quota.
| Argument | Type | Description |
|---|---|---|
| template_id* | string | Template ID, e.g. tpl_1a2b3c (from list_templates). |
{
"type": "object",
"required": [
"template_id"
],
"properties": {
"template_id": {
"type": "string",
"description": "Template ID, e.g. tpl_1a2b3c (from list_templates)."
}
}
}List a fillable PDF's form fields: name, type, current value, options and page. Use the names with fill_pdf_form. Does not use render quota.
| Argument | Type | Description |
|---|---|---|
| file* | object | The PDF form. |
{
"type": "object",
"required": [
"file"
],
"properties": {
"file": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) URL of the PDF."
},
"base64": {
"type": "string",
"description": "The PDF as base64. Use url instead for files over a few MB."
},
"password": {
"type": "string",
"description": "Password, if the PDF is protected."
}
},
"description": "The PDF form."
}
}
}List every template saved in the PDFOven account, newest first, as JSON with id, name, engine and sample_data. Use an id with render_pdf/render_image (template_id) or get_template. Does not use render quota.
No arguments.
{
"type": "object",
"properties": {}
}Join 2-50 PDFs into one, in order, optionally picking pages from each. Returns the merged PDF as a base64 resource. Uses one render from the monthly quota.
| Argument | Type | Description |
|---|---|---|
| files* | array | |
| filename | string |
{
"type": "object",
"required": [
"files"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) URL of the PDF."
},
"pages": {
"type": "string",
"description": "Pages like \"1-3,5,8-\" or \"last\". Ranges can run backwards (\"last-1\") to reverse order."
},
"base64": {
"type": "string",
"description": "The PDF as base64. Use url instead for files over a few MB."
},
"password": {
"type": "string",
"description": "Password, if the PDF is protected."
}
},
"description": "A PDF to include."
},
"minItems": 1
},
"filename": {
"type": "string"
}
}
}Render a PNG image from exactly one source: html, markdown, url (a website screenshot), template (+data) or template_id (+data). Built-in 1200x630 social cards: tpl_og_article, tpl_og_product and tpl_og_announcement. Returns the image inline. Each successful call uses one render from the monthly quota; nothing is stored.
| Argument | Type | Description |
|---|---|---|
| css | string | Extra CSS to apply. |
| url | string | Public http(s) URL to capture. |
| data | object | JSON data for template or template_id. |
| html | string | HTML document or fragment to render. |
| options | object | |
| markdown | string | Markdown to render. |
| template | string | Inline Handlebars HTML template, filled with `data`. |
| template_id | string | ID of a saved template (from list_templates), filled with `data`. |
{
"type": "object",
"properties": {
"css": {
"type": "string",
"description": "Extra CSS to apply."
},
"url": {
"type": "string",
"description": "Public http(s) URL to capture."
},
"data": {
"type": "object",
"description": "JSON data for template or template_id."
},
"html": {
"type": "string",
"description": "HTML document or fragment to render."
},
"options": {
"type": "object",
"properties": {
"width": {
"type": "integer",
"description": "Viewport width in pixels, 16-4000. Default 1280."
},
"height": {
"type": "integer",
"description": "Viewport height in pixels, 16-4000. Default 800."
},
"delay_ms": {
"type": "integer",
"description": "Wait this long after the page loads, 0-10000 ms."
},
"selector": {
"type": "string",
"description": "Capture only the first element matching this CSS selector."
},
"full_page": {
"type": "boolean",
"description": "Capture the full scrollable page instead of the viewport."
},
"color_scheme": {
"enum": [
"light",
"dark"
],
"type": "string",
"description": "Ask the page for its light or dark theme."
},
"hide_selectors": {
"type": "array",
"items": {
"type": "string"
},
"description": "CSS selectors to hide before capturing, e.g. cookie banners."
},
"device_scale_factor": {
"type": "number",
"description": "Pixel density, 1-3: 1 standard, 2 retina."
}
}
},
"markdown": {
"type": "string",
"description": "Markdown to render."
},
"template": {
"type": "string",
"description": "Inline Handlebars HTML template, filled with `data`."
},
"template_id": {
"type": "string",
"description": "ID of a saved template (from list_templates), filled with `data`."
}
}
}Render a PDF from exactly one source: html, markdown, url, template (+data) or template_id (+data). Returns the PDF as a base64 embedded resource. Each successful call uses one render from the account's monthly quota; nothing is stored. Over quota or invalid input returns a tool error explaining why.
| Argument | Type | Description |
|---|---|---|
| css | string | Extra CSS to apply. |
| url | string | Public http(s) URL to capture. |
| data | object | JSON data for template or template_id. |
| html | string | HTML document or fragment to render. |
| options | object | |
| markdown | string | Markdown to render. |
| template | string | Inline Handlebars HTML template, filled with `data`. |
| template_id | string | ID of a saved template (from list_templates), filled with `data`. |
{
"type": "object",
"properties": {
"css": {
"type": "string",
"description": "Extra CSS to apply."
},
"url": {
"type": "string",
"description": "Public http(s) URL to capture."
},
"data": {
"type": "object",
"description": "JSON data for template or template_id."
},
"html": {
"type": "string",
"description": "HTML document or fragment to render."
},
"options": {
"type": "object",
"properties": {
"format": {
"enum": [
"A3",
"A4",
"A5",
"Letter",
"Legal",
"Tabloid"
],
"type": "string"
},
"margin": {
"type": "string",
"description": "e.g. 0.5in, 12mm, 20px"
},
"landscape": {
"type": "boolean"
},
"print_background": {
"type": "boolean"
}
}
},
"markdown": {
"type": "string",
"description": "Markdown to render."
},
"template": {
"type": "string",
"description": "Inline Handlebars HTML template, filled with `data`."
},
"template_id": {
"type": "string",
"description": "ID of a saved template (from list_templates), filled with `data`."
}
}
}Split a PDF. Send pages to extract one PDF, ranges for one PDF per range (returned as a zip), or every to split into chunks of N pages. Uses one render.
| Argument | Type | Description |
|---|---|---|
| file* | object | The PDF to split. |
| every | integer | Split into parts of this many pages. |
| pages | string | Pages like "1-3,5,8-" or "last". Ranges can run backwards ("last-1") to reverse order. |
| ranges | array | One output PDF per range. |
{
"type": "object",
"required": [
"file"
],
"properties": {
"file": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) URL of the PDF."
},
"base64": {
"type": "string",
"description": "The PDF as base64. Use url instead for files over a few MB."
},
"password": {
"type": "string",
"description": "Password, if the PDF is protected."
}
},
"description": "The PDF to split."
},
"every": {
"type": "integer",
"minimum": 1,
"description": "Split into parts of this many pages."
},
"pages": {
"type": "string",
"description": "Pages like \"1-3,5,8-\" or \"last\". Ranges can run backwards (\"last-1\") to reverse order."
},
"ranges": {
"type": "array",
"items": {
"type": "string",
"description": "Pages like \"1-3,5,8-\" or \"last\". Ranges can run backwards (\"last-1\") to reverse order."
},
"description": "One output PDF per range."
}
}
}Change a saved template. Only the fields you pass are replaced; others keep their current values. Future renders with this template_id use the new version immediately.
| Argument | Type | Description |
|---|---|---|
| css | string | CSS applied when the template renders. |
| name | string | Display name, 1-100 characters. |
| engine | string | How content is interpreted. Default handlebars. |
| content | string | Template body: Handlebars HTML ({{field}}, {{#each items}}) or Markdown. |
| sample_data | object | Example JSON data, used for previews and as documentation of the fields. |
| template_id* | string | Template ID, e.g. tpl_1a2b3c (from list_templates). |
| page_options | object | Default PDF page settings for this template. |
{
"type": "object",
"required": [
"template_id"
],
"properties": {
"css": {
"type": "string",
"description": "CSS applied when the template renders."
},
"name": {
"type": "string",
"description": "Display name, 1-100 characters."
},
"engine": {
"enum": [
"handlebars",
"markdown"
],
"type": "string",
"description": "How content is interpreted. Default handlebars."
},
"content": {
"type": "string",
"description": "Template body: Handlebars HTML ({{field}}, {{#each items}}) or Markdown."
},
"sample_data": {
"type": "object",
"description": "Example JSON data, used for previews and as documentation of the fields."
},
"template_id": {
"type": "string",
"description": "Template ID, e.g. tpl_1a2b3c (from list_templates)."
},
"page_options": {
"type": "object",
"properties": {
"format": {
"enum": [
"A3",
"A4",
"A5",
"Letter",
"Legal",
"Tabloid"
],
"type": "string"
},
"margin": {
"type": "string",
"description": "e.g. 0.5in, 12mm, 20px"
},
"landscape": {
"type": "boolean"
},
"printBackground": {
"type": "boolean"
}
},
"description": "Default PDF page settings for this template."
}
}
}Stamp text (Latin characters) or a PNG/JPEG image onto a PDF's pages: centred and diagonal, tiled, or in a corner. Uses one render.
| Argument | Type | Description |
|---|---|---|
| file* | object | The PDF to watermark. |
| text | string | Watermark text, up to 5 lines. |
| color | string | Hex text color, e.g. #c8155f. |
| image | object | PNG or JPEG image instead of text. |
| pages | string | Pages like "1-3,5,8-" or "last". Ranges can run backwards ("last-1") to reverse order. |
| opacity | number | |
| position | string | |
| rotation | number | Degrees. Defaults to the page diagonal for center and tile. |
{
"type": "object",
"required": [
"file"
],
"properties": {
"file": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) URL of the PDF."
},
"base64": {
"type": "string",
"description": "The PDF as base64. Use url instead for files over a few MB."
},
"password": {
"type": "string",
"description": "Password, if the PDF is protected."
}
},
"description": "The PDF to watermark."
},
"text": {
"type": "string",
"description": "Watermark text, up to 5 lines."
},
"color": {
"type": "string",
"description": "Hex text color, e.g. #c8155f."
},
"image": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"base64": {
"type": "string"
}
},
"description": "PNG or JPEG image instead of text."
},
"pages": {
"type": "string",
"description": "Pages like \"1-3,5,8-\" or \"last\". Ranges can run backwards (\"last-1\") to reverse order."
},
"opacity": {
"type": "number",
"maximum": 1,
"minimum": 0.01
},
"position": {
"enum": [
"center",
"tile",
"top-left",
"top-center",
"top-right",
"bottom-left",
"bottom-center",
"bottom-right"
],
"type": "string"
},
"rotation": {
"type": "number",
"description": "Degrees. Defaults to the page diagonal for center and tile."
}
}
}