create-pdf
Generate PDF documents with text, images, shapes, and full layout control. Supports Unicode fonts, custom page sizes, colors, and precise positioning for simple to complex designs.
Instructions
Create a PDF document with text, images, shapes, and full layout control. Supports progressive enhancement from simple documents to complex designs.
Key Features: • Unicode support: Chinese, Japanese, Korean, Arabic, emoji - auto-detects system fonts • Page setup (custom size, margins, background color) • Text with colors, fonts, positioning, and styling (oblique, spacing, etc.) • Shapes (rectangles, circles, lines) for visual design • Emoji rendering with inline image support
Common Patterns:
Simple Document (no pageSetup needed): [{"type": "heading", "text": "Title"}, {"type": "text", "text": "Body"}]
Styled Document (add colors/background): pageSetup: {"backgroundColor": "#F5F5F5"} content: [{"type": "heading", "text": "Title", "color": "#4A90E2"}]
Custom Layout (letterhead, certificates): [{"type": "rect", "x": 0, "y": 0, "width": 612, "height": 80, "fillColor": "navy"}, {"type": "heading", "text": "Company", "color": "white", "y": 25, "align": "center"}]
Algorithmic Design (tapering fonts, progressive layouts): Calculate values in a loop, then pass to tool: for (let i = 0; i < lines.length; i++) { const progress = i / lines.length; const fontSize = 8 + (progress * 16); // 8pt → 24pt content.push({"type": "text", "text": lines[i], "fontSize": fontSize}); }
Coordinate System: • Origin (0, 0) is top-left corner • Letter size page: 612 x 792 points (8.5" x 11") • 72 points = 1 inch
Tips: • Use "align": "center" for centered text (works with or without "width") • Use "x" to manually position (calculate as: (pageWidth - textWidth) / 2 for centering) • Colors: hex ("#FFD700") or named ("gold", "navy", "black") • Oblique: true for default slant, or number for degrees (15 = italic look) • All pageSetup and visual styling fields are optional - defaults match standard documents
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| author | No | Document author metadata | |
| content | Yes | Array of content items to add to the PDF | |
| filename | No | Optional filename for the PDF (defaults to "document.pdf"). SECURITY: Filenames are sanitized and written to a sandboxed directory: • Default: ~/.mcp-pdf/ • Override: Set PDF_OUTPUT_DIR environment variable • Path traversal attempts (.., /, etc) are blocked • Only alphanumeric, spaces, hyphens, underscores, and dots allowed • If file exists, timestamp is appended automatically | |
| font | No | Font for the PDF (optional - defaults to "auto"). **Default**: "auto" auto-detects Unicode fonts on macOS/Linux/Windows. Works for Chinese, Japanese, Korean, Arabic, emoji, and all languages. Advanced options: • Built-in: Helvetica, Times-Roman, Courier - ASCII/Latin only, no Chinese support • Custom: Absolute path to TTF/OTF font file for special needs **You can omit this parameter** - auto-detection works for 99% of use cases. | |
| pageSetup | No | Optional page setup configuration | |
| title | No | Document title metadata |
Input Schema (JSON Schema)
{
"properties": {
"author": {
"description": "Document author metadata",
"type": "string"
},
"content": {
"description": "Array of content items to add to the PDF",
"items": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"align": {
"description": "Text alignment (default: left)",
"enum": [
"left",
"center",
"right",
"justify"
],
"type": "string"
},
"bold": {
"description": "Use bold font",
"type": "boolean"
},
"characterSpacing": {
"description": "Letter spacing in points",
"type": "number"
},
"color": {
"description": "Text color (hex like #FFD700 or named color like \"gold\", default: black)",
"type": "string"
},
"continued": {
"description": "Text continues inline with next item",
"type": "boolean"
},
"fontSize": {
"description": "Font size in points (default: 12)",
"type": "number"
},
"indent": {
"description": "First line indent in points",
"type": "number"
},
"lineBreak": {
"description": "Enable line wrapping (default: true)",
"type": "boolean"
},
"lineGap": {
"description": "Space between lines in points",
"type": "number"
},
"link": {
"description": "URL to link this text to",
"type": "string"
},
"moveDown": {
"description": "Lines to move down after this item (0 = no spacing)",
"type": "number"
},
"oblique": {
"description": "Slant text (true or angle in degrees)",
"type": [
"boolean",
"number"
]
},
"paragraphGap": {
"description": "Space between paragraphs in points",
"type": "number"
},
"strike": {
"description": "Strikethrough text",
"type": "boolean"
},
"text": {
"description": "Text content",
"type": "string"
},
"type": {
"const": "text",
"description": "Text content",
"type": "string"
},
"underline": {
"description": "Underline text",
"type": "boolean"
},
"width": {
"description": "Text wrapping width in points",
"type": "number"
},
"wordSpacing": {
"description": "Word spacing in points",
"type": "number"
},
"x": {
"description": "X position",
"type": "number"
},
"y": {
"description": "Y position",
"type": "number"
}
},
"required": [
"type"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"align": {
"description": "Text alignment (default: left)",
"enum": [
"left",
"center",
"right",
"justify"
],
"type": "string"
},
"bold": {
"description": "Use bold font (default: true)",
"type": "boolean"
},
"characterSpacing": {
"description": "Letter spacing in points",
"type": "number"
},
"color": {
"description": "Text color (hex like #FFD700 or named color like \"gold\", default: black)",
"type": "string"
},
"continued": {
"description": "Text continues inline with next item",
"type": "boolean"
},
"fontSize": {
"description": "Font size in points (default: 24)",
"type": "number"
},
"indent": {
"description": "First line indent in points",
"type": "number"
},
"lineBreak": {
"description": "Enable line wrapping (default: true)",
"type": "boolean"
},
"lineGap": {
"description": "Space between lines in points",
"type": "number"
},
"link": {
"description": "URL to link this text to",
"type": "string"
},
"moveDown": {
"description": "Lines to move down after this item (0 = no spacing)",
"type": "number"
},
"oblique": {
"description": "Slant text (true or angle in degrees)",
"type": [
"boolean",
"number"
]
},
"paragraphGap": {
"description": "Space between paragraphs in points",
"type": "number"
},
"strike": {
"description": "Strikethrough text",
"type": "boolean"
},
"text": {
"description": "Text content",
"type": "string"
},
"type": {
"const": "heading",
"description": "Heading content",
"type": "string"
},
"underline": {
"description": "Underline text",
"type": "boolean"
},
"width": {
"description": "Text wrapping width in points",
"type": "number"
},
"wordSpacing": {
"description": "Word spacing in points",
"type": "number"
},
"x": {
"description": "X position",
"type": "number"
},
"y": {
"description": "Y position",
"type": "number"
}
},
"required": [
"type"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"height": {
"description": "Image height",
"type": "number"
},
"imagePath": {
"description": "Path to image file",
"type": "string"
},
"type": {
"const": "image",
"description": "Image content",
"type": "string"
},
"width": {
"description": "Image width",
"type": "number"
},
"x": {
"description": "X position",
"type": "number"
},
"y": {
"description": "Y position",
"type": "number"
}
},
"required": [
"type",
"imagePath"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"fillColor": {
"description": "Fill color (hex like #FFD700 or named color)",
"type": "string"
},
"height": {
"description": "Height in points",
"type": "number"
},
"lineWidth": {
"description": "Stroke width in points (default: 1)",
"type": "number"
},
"strokeColor": {
"description": "Stroke/border color",
"type": "string"
},
"type": {
"const": "rect",
"description": "Rectangle shape",
"type": "string"
},
"width": {
"description": "Width in points",
"type": "number"
},
"x": {
"description": "X position (top-left corner)",
"type": "number"
},
"y": {
"description": "Y position (top-left corner)",
"type": "number"
}
},
"required": [
"type",
"x",
"y",
"width",
"height"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"fillColor": {
"description": "Fill color (hex like #FFD700 or named color)",
"type": "string"
},
"lineWidth": {
"description": "Stroke width in points (default: 1)",
"type": "number"
},
"radius": {
"description": "Radius in points",
"type": "number"
},
"strokeColor": {
"description": "Stroke/border color",
"type": "string"
},
"type": {
"const": "circle",
"description": "Circle shape",
"type": "string"
},
"x": {
"description": "Center X position",
"type": "number"
},
"y": {
"description": "Center Y position",
"type": "number"
}
},
"required": [
"type",
"x",
"y",
"radius"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"lineWidth": {
"description": "Line width in points (default: 1)",
"type": "number"
},
"strokeColor": {
"description": "Line color (default: black)",
"type": "string"
},
"type": {
"const": "line",
"description": "Line shape",
"type": "string"
},
"x1": {
"description": "Start X position",
"type": "number"
},
"x2": {
"description": "End X position",
"type": "number"
},
"y1": {
"description": "Start Y position",
"type": "number"
},
"y2": {
"description": "End Y position",
"type": "number"
}
},
"required": [
"type",
"x1",
"y1",
"x2",
"y2"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"type": {
"const": "pageBreak",
"description": "Page break",
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
]
},
"type": "array"
},
"filename": {
"description": "Optional filename for the PDF (defaults to \"document.pdf\").\n\nSECURITY: Filenames are sanitized and written to a sandboxed directory:\n• Default: ~/.mcp-pdf/\n• Override: Set PDF_OUTPUT_DIR environment variable\n• Path traversal attempts (.., /, etc) are blocked\n• Only alphanumeric, spaces, hyphens, underscores, and dots allowed\n• If file exists, timestamp is appended automatically",
"type": "string"
},
"font": {
"description": "Font for the PDF (optional - defaults to \"auto\").\n\n**Default**: \"auto\" auto-detects Unicode fonts on macOS/Linux/Windows. Works for Chinese, Japanese, Korean, Arabic, emoji, and all languages.\n\nAdvanced options:\n• Built-in: Helvetica, Times-Roman, Courier - ASCII/Latin only, no Chinese support\n• Custom: Absolute path to TTF/OTF font file for special needs\n\n**You can omit this parameter** - auto-detection works for 99% of use cases.",
"type": "string"
},
"pageSetup": {
"additionalProperties": false,
"description": "Optional page setup configuration",
"properties": {
"backgroundColor": {
"description": "Page background color (hex like #000000 or named color like \"black\")",
"type": "string"
},
"margins": {
"additionalProperties": false,
"description": "Page margins in points (default: {top: 72, bottom: 72, left: 72, right: 72})",
"properties": {
"bottom": {
"description": "Bottom margin in points",
"type": "number"
},
"left": {
"description": "Left margin in points",
"type": "number"
},
"right": {
"description": "Right margin in points",
"type": "number"
},
"top": {
"description": "Top margin in points",
"type": "number"
}
},
"required": [
"top",
"bottom",
"left",
"right"
],
"type": "object"
},
"size": {
"description": "Page size [width, height] in points (default: [612, 792] = Letter)",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
}
},
"type": "object"
},
"title": {
"description": "Document title metadata",
"type": "string"
}
},
"required": [
"content"
],
"type": "object"
}