Create PDF

What the AI client sees

The AI client sees one named MCP tool with two fields: required Markdown source and an optional filename. The tool returns structured artifact metadata instead of inline PDF bytes: status, download URL, filename, MIME type, password requirement, expiry time, and a suggested polling interval.

Markdown in, URL out

Field	Required	Purpose
source	Yes	Markdown text to render into the PDF body.
filename	No	Suggested PDF filename. Vectoralix normalizes it and adds .pdf when needed.

The input contract is Markdown-only. Raw HTML is not a supported caller input mode, and Markdown images are stripped before the browser renderer runs so the PDF job cannot fetch arbitrary remote URLs.

Why generation is asynchronous

PDF rendering uses a browser engine and can take seconds or minutes. Vectoralix therefore reserves an artifact immediately, queues rendering in the background, and returns a download URL right away. While the job is queued or processing, the download URL returns 202 Accepted with a Retry-After header. When rendering succeeds, the same URL streams the finished PDF.

Download behavior

• Queued or processing artifacts return 202 Accepted and tell clients when to poll again.
• Ready artifacts stream as application/pdf with an attachment filename.
• Failed artifacts show a generic failure response. The original Markdown is cleared after success or permanent failure.
• Expired or deleted artifacts return 410 Gone.

Private storage, public-looking link

The download URL is a Vectoralix URL, not an S3 URL. The underlying object is stored on a private PDF artifact disk and is never exposed to the model as a presigned S3 URL. Vectoralix checks the artifact token, status, expiry, and password before streaming the object.

Optional password

A Create PDF tool can require a download password. Vectoralix stores only password hashes. Existing artifacts keep the password setting they had when they were created, so changing the tool password later does not silently change old links.

• Without a password, anyone with the long Vectoralix URL can download the PDF until it expires.
• With a password, browsers get a password form and automation can send X-Vectoralix-Pdf-Password.
• Passwords are not accepted in the query string because URLs leak through browser history, referrers, proxy logs, and CDN logs.

Configuration

Open the tool, choose Create PDF, then configure page format, orientation, margins, optional header/footer Markdown, page number placement, filename template, and optional download password. The Test PDF action reserves an artifact through the same queue-backed path used by live MCP calls.

Limits and cleanup

• Source Markdown and generated PDF size are capped to protect the renderer and storage.
• Active and hourly artifact limits prevent one organization or tool from filling the queue.
• Artifacts expire automatically. A scheduled cleanup command removes expired private objects and marks their database rows expired.