html_to_pdf_wk
Convert HTML to PDF using the wkhtmltopdf rendering engine. Supports JavaScript execution and screen-capture style rendering. Good for simple documents, web page snapshots, layouts that rely on JavaScript, and fillable PDF forms (set pdfForms to true). Available on all PdfBroker.io plans including the free tier. Does NOT support PDF/A or PDF/UA compliance — use html_to_pdf for compliant documents. Does NOT honour CSS '@page { size: ... }' — page geometry comes from paperSize and orientation; use html_to_pdf when the document's own stylesheet must decide. EU-first defaults: A4 paper, Portrait orientation.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "html_to_pdf_wk"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Optional https URL of an already published HTML document or web page, fetched by PdfBroker instead of sending the markup inline. Use this to keep a large template out of the conversation, or to snapshot a live page. Only https is accepted, and addresses on private networks or cloud metadata endpoints are refused. If both 'url' and 'html' are supplied, 'url' wins. Relative images, fonts and stylesheets resolve against the document's own URL, so the 'resources' parameter has no effect on a url render. This engine renders whatever the address returns, including a 404 or a login page — it does not check the HTTP status — so a wrong or protected URL comes back as a PDF of that page rather than as an error. Check the URL before relying on the output. | |
| html | No | HTML content to convert. Can be a full document or a fragment. Optional if 'url' is supplied instead — pass exactly one of the two. | |
| pdfForms | No | Set to true to produce a fillable PDF: the document's <input>, <select> and <textarea> elements become interactive form fields a recipient can type into and save. Default false, which flattens them into static text. | |
| paperSize | No | Paper size: 'Auto' (default) leaves it to the engine, which uses A4 (EU-first default). Name a size to set it explicitly: 'A4', 'Letter', 'A3', 'Legal'. Note that wkhtmltopdf does NOT honour CSS '@page { size: ... }' — if the page geometry must come from the document's own stylesheet, use the html_to_pdf tool. | Auto |
| resources | No | Optional embedded resources referenced by relative path in the HTML. Keys are relative paths (e.g., 'images/logo.png'), values are base64-encoded file contents. Unused entries are silently ignored. Invalid base64 returns a clear, key-named error before the API call is made. | |
| orientation | No | Page orientation: 'Auto' (default, engine default is Portrait), 'Portrait' or 'Landscape'. | Auto |
| extraArguments | No | Optional extra wkhtmltopdf engine arguments forwarded verbatim to the engine. Keys are CLI long-form options without '--'. For switch-style flags use an empty-string value — example: {"enable-forms": ""} to make form fields in the rendered PDF interactive. On key collision with structured parameters (paperSize, orientation), the user-supplied extra wins. See the docs://pdfbroker/api-reference resource for the supported argument list. |