com.makespdf/makespdf is an MCP server published by com.makespdf, hosted at makespdf.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 12 tools, including render_markdown, render_template, list_templates, get_template, validate_markdown.
Compliant PDFs (PDF/A-2A + PDF/UA-1) from markdown or a compact DSL - fast, no headless browser.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Create a PDF document from markdown text. Use when the user asks for a PDF of written content, such as notes, a report, a summary, a letter, a list, a checklist or a diagram. Supports GitHub-flavored markdown, tables, task lists, Mermaid diagrams (flowcharts, sequence and other diagram types), code highlighting and images; the output is a tagged, accessible PDF (PDF/A-2A + PDF/UA-1). Uses the user's makesPDF credits: 1 credit per 10 pages. Returns JSON metadata (pageCount, creditsDeducted, creditsRemaining, artifactId, downloadUrl) plus the PDF bytes as an embedded base64 resource and a resource_link to `downloadUrl`. On the Free and Hobbyist plans, unless the account holds Growth credits, each page carries a small makespdf.com link. Mirrors POST /api/v1/md.
| Parameter | Type | Description |
|---|---|---|
| options | object | Optional render settings. Anything omitted falls back to YAML frontmatter in the markdown, then to the runtime default. |
| markdown * | string |
None yet. Changes appear after a server's second daily check.
| The GitHub-flavored markdown document to render. YAML frontmatter may set the same keys as `options`. Up to 200KB of text; inline data: image payloads do not count toward that. |
{
"name": "render_markdown",
"title": "Render markdown",
"description": "Create a PDF document from markdown text. Use when the user asks for a PDF of written content, such as notes, a report, a summary, a letter, a list, a checklist or a diagram. Supports GitHub-flavored markdown, tables, task lists, Mermaid diagrams (flowcharts, sequence and other diagram types), code highlighting and images; the output is a tagged, accessible PDF (PDF/A-2A + PDF/UA-1). Uses the user's makesPDF credits: 1 credit per 10 pages. Returns JSON metadata (pageCount, creditsDeducted, creditsRemaining, artifactId, downloadUrl) plus the PDF bytes as an embedded base64 resource and a resource_link to `downloadUrl`. On the Free and Hobbyist plans, unless the account holds Growth credits, each page carries a small makespdf.com link. Mirrors POST /api/v1/md.",
"inputSchema": {
"type": "object",
"required": [
"markdown"
],
"properties": {
"options": {
"type": "object",
"properties": {
"theme": {
"enum": [
"default",
"github"
],
"type": "string",
"default": "github",
"description": "Visual style. 'github': lighter semibold headings, underlined h1/h2, zebra-striped bordered tables. 'default': heavier bold headings with no underlines or striping."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Document title written to the PDF metadata. PDF viewers show it in the window title instead of the file name. When omitted, frontmatter `title` applies, else 'Document'."
},
"author": {
"type": "string",
"maxLength": 200,
"description": "Document author, written to the PDF metadata."
},
"margins": {
"type": "array",
"items": {
"type": "number"
},
"description": "Page margins in points, [top, right, bottom, left]. When omitted, frontmatter `margins` applies, else 40 on every side."
},
"subject": {
"type": "string",
"maxLength": 200,
"description": "One-line summary of the document, written to the PDF metadata."
},
"fontSize": {
"type": "number",
"default": 10,
"maximum": 24,
"minimum": 6,
"description": "Body text size in points. Headings, spacing and line height scale from it."
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "Search keywords, written to the PDF metadata."
},
"pageSize": {
"enum": [
"A3",
"A4",
"A5",
"Letter",
"Legal"
],
"type": "string",
"default": "A4",
"description": "Paper size for every page."
},
"splitMode": {
"enum": [
"default",
"balanced"
],
"type": "string",
"description": "How sections break across pages. 'default' keeps each section together where it can; 'balanced' splits large sections to fill pages and leave fewer gaps."
},
"fontFamily": {
"enum": [
"Inter",
"NotoSans"
],
"type": "string",
"default": "Inter",
"description": "Body font: 'Inter' (geometric sans) or 'NotoSans' (humanist sans). Code blocks always use a monospace font."
},
"pageNumbers": {
"enum": [
"page-n-of-total",
"n-of-total",
"n"
],
"type": "string",
"description": "Footer page-number format: 'page-n-of-total' (Page 3 of 12), 'n-of-total' (3 / 12), or 'n' (3). Omit for no page numbers."
},
"pageNumberPosition": {
"enum": [
"left",
"center",
"right"
],
"type": "string",
"default": "right",
"description": "Footer alignment of the page number. Ignored without pageNumbers."
}
},
"description": "Optional render settings. Anything omitted falls back to YAML frontmatter in the markdown, then to the runtime default."
},
"markdown": {
"type": "string",
"description": "The GitHub-flavored markdown document to render. YAML frontmatter may set the same keys as `options`. Up to 200KB of text; inline data: image payloads do not count toward that."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"pageCount",
"sizeBytes",
"renderMs",
"creditsDeducted",
"creditsRemaining"
],
"properties": {
"renderMs": {
"type": "integer",
"description": "Server-side render time in milliseconds."
},
"pageCount": {
"type": "integer",
"description": "Pages in the rendered PDF."
},
"sizeBytes": {
"type": "integer",
"description": "Size of the PDF in bytes."
},
"artifactId": {
"type": "string",
"description": "ID of the stored render artifact, also served at GET /api/v1/artifacts/{id}/pdf. Absent when the artifact could not be recorded."
},
"downloadUrl": {
"type": "string",
"description": "Short-lived signed URL that downloads the rendered PDF with no credential of its own. Absent when the artifact could not be recorded."
},
"creditsDeducted": {
"type": "integer",
"description": "Credits charged for this render: 1 per 10 pages, rounded up; 0 when the caller is not billed."
},
"creditsRemaining": {
"type": [
"number",
"null"
],
"description": "Credit balance after the charge; null when the caller is not billed."
},
"downloadUrlExpiresAt": {
"type": "string",
"description": "When `downloadUrl` stops working, as an ISO 8601 timestamp."
}
},
"description": "Render and billing metadata. The PDF itself is the embedded resource in `content`."
},
"annotations": {
"title": "Render markdown",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a PDF from a stored template (a curated makesPDF library template or one the user saved) filled with the user's data. Use when the user asks for a PDF of a structured document, such as an invoice, receipt, quote, certificate or resume, that a template covers. Uses the user's makesPDF credits: 1 credit per 10 pages. Returns JSON metadata (pageCount, creditsDeducted, creditsRemaining, artifactId, downloadUrl) plus the PDF bytes as an embedded base64 resource and a resource_link to `downloadUrl`. On the Free and Hobbyist plans, unless the account holds Growth credits, each page carries a small makespdf.com link. Mirrors POST /api/v1/render with the { templateId, data } body shape.
| Parameter | Type | Description |
|---|---|---|
| data | object | Binding data substituted into {{var}} expressions. When omitted, the `const sampleData` declared inside the template's DSL is used; the separately stored sampleData field is not. |
| title | string | Document title written to the PDF metadata. PDF viewers show it in the window title instead of the file name. When omitted, the template's saved name is used; a title set in the DSL's doc() is not. |
| templateId * | string | Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows. |
{
"name": "render_template",
"title": "Render template",
"description": "Create a PDF from a stored template (a curated makesPDF library template or one the user saved) filled with the user's data. Use when the user asks for a PDF of a structured document, such as an invoice, receipt, quote, certificate or resume, that a template covers. Uses the user's makesPDF credits: 1 credit per 10 pages. Returns JSON metadata (pageCount, creditsDeducted, creditsRemaining, artifactId, downloadUrl) plus the PDF bytes as an embedded base64 resource and a resource_link to `downloadUrl`. On the Free and Hobbyist plans, unless the account holds Growth credits, each page carries a small makespdf.com link. Mirrors POST /api/v1/render with the { templateId, data } body shape.",
"inputSchema": {
"type": "object",
"required": [
"templateId"
],
"properties": {
"data": {
"type": "object",
"description": "Binding data substituted into {{var}} expressions. When omitted, the `const sampleData` declared inside the template's DSL is used; the separately stored sampleData field is not."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Document title written to the PDF metadata. PDF viewers show it in the window title instead of the file name. When omitted, the template's saved name is used; a title set in the DSL's doc() is not."
},
"templateId": {
"type": "string",
"description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"templateId",
"pageCount",
"sizeBytes",
"renderMs",
"creditsDeducted",
"creditsRemaining",
"templateWarnings"
],
"properties": {
"renderMs": {
"type": "integer",
"description": "Server-side render time in milliseconds."
},
"pageCount": {
"type": "integer",
"description": "Pages in the rendered PDF."
},
"sizeBytes": {
"type": "integer",
"description": "Size of the PDF in bytes."
},
"artifactId": {
"type": "string",
"description": "ID of the stored render artifact, also served at GET /api/v1/artifacts/{id}/pdf. Absent when the artifact could not be recorded."
},
"templateId": {
"type": "string",
"description": "Template ID: a slug for library templates, a UUID for your own."
},
"downloadUrl": {
"type": "string",
"description": "Short-lived signed URL that downloads the rendered PDF with no credential of its own. Absent when the artifact could not be recorded."
},
"creditsDeducted": {
"type": "integer",
"description": "Credits charged for this render: 1 per 10 pages, rounded up; 0 when the caller is not billed."
},
"creditsRemaining": {
"type": [
"number",
"null"
],
"description": "Credit balance after the charge; null when the caller is not billed."
},
"templateWarnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"expression"
],
"properties": {
"code": {
"type": "string",
"description": "Warning kind, e.g. 'unknown-filter'."
},
"detail": {
"type": "string",
"description": "Human-readable explanation, when available."
},
"expression": {
"type": "string",
"description": "The expression source that failed."
}
}
},
"description": "Problems found while binding data (unsupported expressions, unknown filters, bad currency codes, invalid chart data, …). Unresolved expressions render as empty text and bad chart data affects the chart. Each originates in the DSL or the data."
},
"downloadUrlExpiresAt": {
"type": "string",
"description": "When `downloadUrl` stops working, as an ISO 8601 timestamp."
}
},
"description": "Render and billing metadata. The PDF itself is the embedded resource in `content`."
},
"annotations": {
"title": "Render template",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}List templates visible to the caller: the curated makesPDF library and the caller's own saved templates. Returns metadata only (no DSL), one page at a time. Mirrors GET /api/v1/templates.
| Parameter | Type | Description |
|---|---|---|
| q | string | Free text matched as a case-insensitive substring against template names and descriptions. |
| tags | string | Comma-separated tags; a template must carry every one to match, e.g. 'receipt,retail'. The `tags` field of earlier results shows the values in use. |
| limit | integer | Page size: how many templates to return. |
| owner | string | Whose templates to list: 'mine' for templates you saved, 'library' for the curated makesPDF catalog, 'all' for both. |
| offset | integer | How many matching templates to skip, for paging. Add `limit` to it to fetch the next page. |
| category | string | Document type to match exactly. Library templates use 'certificate', 'civic', 'form', 'invoice', 'letter', 'quote', 'receipt', 'report', 'resume', 'shipping-label' and 'statement'; your own templates may use others, shown in the `category` field of earlier results. |
{
"name": "list_templates",
"title": "List templates",
"description": "List templates visible to the caller: the curated makesPDF library and the caller's own saved templates. Returns metadata only (no DSL), one page at a time. Mirrors GET /api/v1/templates.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 128,
"description": "Free text matched as a case-insensitive substring against template names and descriptions."
},
"tags": {
"type": "string",
"maxLength": 256,
"description": "Comma-separated tags; a template must carry every one to match, e.g. 'receipt,retail'. The `tags` field of earlier results shows the values in use."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Page size: how many templates to return."
},
"owner": {
"enum": [
"mine",
"library",
"all"
],
"type": "string",
"default": "all",
"description": "Whose templates to list: 'mine' for templates you saved, 'library' for the curated makesPDF catalog, 'all' for both."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "How many matching templates to skip, for paging. Add `limit` to it to fetch the next page."
},
"category": {
"type": "string",
"maxLength": 64,
"description": "Document type to match exactly. Library templates use 'certificate', 'civic', 'form', 'invoice', 'letter', 'quote', 'receipt', 'report', 'resume', 'shipping-label' and 'statement'; your own templates may use others, shown in the `category` field of earlier results."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"templates",
"total",
"limit",
"offset"
],
"properties": {
"limit": {
"type": "integer",
"description": "Page size used."
},
"total": {
"type": "integer",
"description": "Matching templates across all pages."
},
"offset": {
"type": "integer",
"description": "Offset used."
},
"templates": {
"type": "array",
"items": {
"type": "object",
"required": [
"templateId",
"ownerUserId",
"name",
"description",
"category",
"tags",
"createdAt",
"updatedAt"
],
"properties": {
"name": {
"type": "string",
"description": "Display name."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for filtering."
},
"category": {
"type": [
"string",
"null"
],
"description": "Document type (e.g. 'invoice'); null when uncategorised."
},
"createdAt": {
"type": "string",
"description": "When the template was created, as a UTC 'YYYY-MM-DD HH:MM:SS' timestamp."
},
"updatedAt": {
"type": "string",
"description": "When the template was last changed, as a UTC 'YYYY-MM-DD HH:MM:SS' timestamp."
},
"templateId": {
"type": "string",
"description": "Template ID: a slug for library templates, a UUID for your own."
},
"description": {
"type": "string",
"description": "One-sentence summary; empty when none is stored."
},
"ownerUserId": {
"type": [
"string",
"null"
],
"description": "Owner's user ID, or null for a curated library template."
}
}
},
"description": "One page of matching templates, metadata only."
}
}
},
"annotations": {
"title": "List templates",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch a single template (library or caller-owned) by ID, including its full DSL source and sampleData. Mirrors GET /api/v1/templates/:id.
| Parameter | Type | Description |
|---|---|---|
| templateId * | string | Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows. |
{
"name": "get_template",
"title": "Get template",
"description": "Fetch a single template (library or caller-owned) by ID, including its full DSL source and sampleData. Mirrors GET /api/v1/templates/:id.",
"inputSchema": {
"type": "object",
"required": [
"templateId"
],
"properties": {
"templateId": {
"type": "string",
"description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"templateId",
"ownerUserId",
"name",
"description",
"category",
"tags",
"createdAt",
"updatedAt",
"dsl",
"sampleData"
],
"properties": {
"dsl": {
"type": "string",
"description": "The template's builder DSL source."
},
"name": {
"type": "string",
"description": "Display name."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for filtering."
},
"category": {
"type": [
"string",
"null"
],
"description": "Document type (e.g. 'invoice'); null when uncategorised."
},
"createdAt": {
"type": "string",
"description": "When the template was created, as a UTC 'YYYY-MM-DD HH:MM:SS' timestamp."
},
"updatedAt": {
"type": "string",
"description": "When the template was last changed, as a UTC 'YYYY-MM-DD HH:MM:SS' timestamp."
},
"sampleData": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"description": "Sample binding data stored with the template, or null. render_template without `data` uses the DSL's own `const sampleData`, not this."
},
"templateId": {
"type": "string",
"description": "Template ID: a slug for library templates, a UUID for your own."
},
"description": {
"type": "string",
"description": "One-sentence summary; empty when none is stored."
},
"ownerUserId": {
"type": [
"string",
"null"
],
"description": "Owner's user ID, or null for a curated library template."
}
}
},
"annotations": {
"title": "Get template",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Validate a markdown document for PDF/UA-1 accessibility issues (heading hierarchy, missing alt text). Cheap — no rendering. Returns JSON { valid, issues: [{ severity, message, path, rule }], summary: { errors, warnings } }; `valid` is false when any issue has severity 'error'. Mirrors POST /api/v1/md/validate.
| Parameter | Type | Description |
|---|---|---|
| markdown * | string | The GitHub-flavored markdown document to check, exactly as it would be passed to render_markdown. Up to 200KB of text; inline data: image payloads do not count toward that. |
{
"name": "validate_markdown",
"title": "Validate markdown",
"description": "Validate a markdown document for PDF/UA-1 accessibility issues (heading hierarchy, missing alt text). Cheap — no rendering. Returns JSON { valid, issues: [{ severity, message, path, rule }], summary: { errors, warnings } }; `valid` is false when any issue has severity 'error'. Mirrors POST /api/v1/md/validate.",
"inputSchema": {
"type": "object",
"required": [
"markdown"
],
"properties": {
"markdown": {
"type": "string",
"description": "The GitHub-flavored markdown document to check, exactly as it would be passed to render_markdown. Up to 200KB of text; inline data: image payloads do not count toward that."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"valid",
"issues",
"summary"
],
"properties": {
"valid": {
"type": "boolean",
"description": "False when any issue has severity 'error'; warnings alone leave it true."
},
"issues": {
"type": "array",
"items": {
"type": "object",
"required": [
"severity",
"message",
"path",
"rule"
],
"properties": {
"path": {
"type": "string",
"description": "Location in the document tree (e.g. 'kids[0].kids[2]'); empty when it applies to the whole document."
},
"rule": {
"type": "string",
"description": "Identifier of the check that raised the issue."
},
"message": {
"type": "string",
"description": "What is wrong and, usually, how to fix it."
},
"severity": {
"enum": [
"error",
"warning"
],
"type": "string"
}
}
},
"description": "Every problem found, errors and warnings together."
},
"summary": {
"type": "object",
"required": [
"errors",
"warnings"
],
"properties": {
"errors": {
"type": "integer",
"description": "Number of issues with severity 'error'."
},
"warnings": {
"type": "integer",
"description": "Number of issues with severity 'warning'."
}
}
}
}
},
"annotations": {
"title": "Validate markdown",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Validate a PDF template DSL script for structure, tag/style correctness, and accessibility issues. Runs catalog validation plus alt-text checks. Cheap — no rendering. Returns JSON { valid, issues: [{ severity, message, path, rule }], summary: { errors, warnings } }; `valid` is false when any issue has severity 'error', and a script that fails to execute comes back as a single 'dsl-execution' error rather than a tool error. Mirrors POST /api/v1/preview/validate.
| Parameter | Type | Description |
|---|---|---|
| dsl * | string | The builder DSL script to validate. Must assign `const template = doc(...)`. |
| data | object | Optional binding data. Falls back to the script's sampleData when omitted. |
{
"name": "validate_dsl",
"title": "Validate template DSL",
"description": "Validate a PDF template DSL script for structure, tag/style correctness, and accessibility issues. Runs catalog validation plus alt-text checks. Cheap — no rendering. Returns JSON { valid, issues: [{ severity, message, path, rule }], summary: { errors, warnings } }; `valid` is false when any issue has severity 'error', and a script that fails to execute comes back as a single 'dsl-execution' error rather than a tool error. Mirrors POST /api/v1/preview/validate.",
"inputSchema": {
"type": "object",
"required": [
"dsl"
],
"properties": {
"dsl": {
"type": "string",
"description": "The builder DSL script to validate. Must assign `const template = doc(...)`."
},
"data": {
"type": "object",
"description": "Optional binding data. Falls back to the script's sampleData when omitted."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"valid",
"issues",
"summary"
],
"properties": {
"valid": {
"type": "boolean",
"description": "False when any issue has severity 'error'; warnings alone leave it true."
},
"issues": {
"type": "array",
"items": {
"type": "object",
"required": [
"severity",
"message",
"path",
"rule"
],
"properties": {
"path": {
"type": "string",
"description": "Location in the document tree (e.g. 'kids[0].kids[2]'); empty when it applies to the whole document."
},
"rule": {
"type": "string",
"description": "Identifier of the check that raised the issue."
},
"message": {
"type": "string",
"description": "What is wrong and, usually, how to fix it."
},
"severity": {
"enum": [
"error",
"warning"
],
"type": "string"
}
}
},
"description": "Every problem found, errors and warnings together."
},
"summary": {
"type": "object",
"required": [
"errors",
"warnings"
],
"properties": {
"errors": {
"type": "integer",
"description": "Number of issues with severity 'error'."
},
"warnings": {
"type": "integer",
"description": "Number of issues with severity 'warning'."
}
}
}
}
},
"annotations": {
"title": "Validate template DSL",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Render a DSL template + data to a preview PDF. Free (no credits), always watermarked 'PREVIEW — NOT FOR USE'. Returns JSON metadata plus the PDF bytes as an embedded base64 resource. No artifact is recorded, so there is no download URL or resource link. Mirrors POST /api/v1/preview.
| Parameter | Type | Description |
|---|---|---|
| dsl * | string | The template source: a builder DSL script that assigns `const template = doc(...)` and optionally `const sampleData = {...}`. |
| data | object | Optional binding data. Falls back to the script's sampleData when omitted. |
| title | string | Document title written to the PDF metadata. PDF viewers show it in the window title instead of the file name. When omitted, the title is 'Document'; a title set in the DSL's doc() is not used. |
{
"name": "render_dsl_preview",
"title": "Preview template PDF",
"description": "Render a DSL template + data to a preview PDF. Free (no credits), always watermarked 'PREVIEW — NOT FOR USE'. Returns JSON metadata plus the PDF bytes as an embedded base64 resource. No artifact is recorded, so there is no download URL or resource link. Mirrors POST /api/v1/preview.",
"inputSchema": {
"type": "object",
"required": [
"dsl"
],
"properties": {
"dsl": {
"type": "string",
"description": "The template source: a builder DSL script that assigns `const template = doc(...)` and optionally `const sampleData = {...}`."
},
"data": {
"type": "object",
"description": "Optional binding data. Falls back to the script's sampleData when omitted."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Document title written to the PDF metadata. PDF viewers show it in the window title instead of the file name. When omitted, the title is 'Document'; a title set in the DSL's doc() is not used."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"pageCount",
"sizeBytes",
"renderMs",
"templateWarnings"
],
"properties": {
"renderMs": {
"type": "integer",
"description": "Server-side render time in milliseconds."
},
"pageCount": {
"type": "integer",
"description": "Pages in the rendered PDF."
},
"sizeBytes": {
"type": "integer",
"description": "Size of the PDF in bytes."
},
"templateWarnings": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"expression"
],
"properties": {
"code": {
"type": "string",
"description": "Warning kind, e.g. 'unknown-filter'."
},
"detail": {
"type": "string",
"description": "Human-readable explanation, when available."
},
"expression": {
"type": "string",
"description": "The expression source that failed."
}
}
},
"description": "Problems found while binding data (unsupported expressions, unknown filters, bad currency codes, invalid chart data, …). Unresolved expressions render as empty text and bad chart data affects the chart. Each originates in the DSL or the data."
}
},
"description": "Render metadata. The PDF itself is the embedded resource in `content`."
},
"annotations": {
"title": "Preview template PDF",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Save a user-owned DSL template so it can be rendered later by ID. Validates the DSL with the catalog before persisting. Free (no credits). Optional `sampleData` (any JSON value) is stored with the template and returned whenever the template is fetched, preserving the template's binding shape. Optional `description` is a one-sentence summary surfaced on /templates. Returns { templateId, name, createdAt }.
| Parameter | Type | Description |
|---|---|---|
| dsl * | string | The builder DSL script to store. It is validated before saving. Up to 512KB. |
| name * | string | Display name shown in list_templates results and on the /templates page. |
| sampleData | ["object","array","string","number","boo… | Optional JSON binding data to persist alongside the template. Returned by get_template. |
| description | string | One-sentence summary of what the template is for. Shown on /templates list rows and matched by list_templates `q`. |
{
"name": "save_template",
"title": "Save template",
"description": "Save a user-owned DSL template so it can be rendered later by ID. Validates the DSL with the catalog before persisting. Free (no credits). Optional `sampleData` (any JSON value) is stored with the template and returned whenever the template is fetched, preserving the template's binding shape. Optional `description` is a one-sentence summary surfaced on /templates. Returns { templateId, name, createdAt }.",
"inputSchema": {
"type": "object",
"required": [
"dsl",
"name"
],
"properties": {
"dsl": {
"type": "string",
"description": "The builder DSL script to store. It is validated before saving. Up to 512KB."
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Display name shown in list_templates results and on the /templates page."
},
"sampleData": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"description": "Optional JSON binding data to persist alongside the template. Returned by get_template."
},
"description": {
"type": "string",
"maxLength": 280,
"description": "One-sentence summary of what the template is for. Shown on /templates list rows and matched by list_templates `q`."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"templateId",
"name",
"createdAt"
],
"properties": {
"name": {
"type": "string",
"description": "The display name as saved."
},
"createdAt": {
"type": "string",
"description": "When the template was created, as a UTC 'YYYY-MM-DD HH:MM:SS' timestamp."
},
"templateId": {
"type": "string",
"description": "UUID of the new template."
}
}
},
"annotations": {
"title": "Save template",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Update a saved template's DSL, name, description, and/or sampleData. Revalidates the DSL when provided. A DSL that differs from the stored one is recorded in the template's revision history (History tab on /templates/:id); sending the same DSL again records nothing, and name, description and sampleData are overwritten without history. For `description` and `sampleData`: pass `null` to clear; omit to leave unchanged. Returns { templateId, name, updatedAt }. Mirrors PUT /api/v1/templates/:id.
| Parameter | Type | Description |
|---|---|---|
| dsl | string | Replacement builder DSL script; it is validated before saving. Omit to keep the current DSL. Up to 512KB. |
| name | string | New display name. Omit to keep the current name. |
| sampleData | ["object","array","string","number","boo… | Replacement sample binding data, stored alongside the template and returned by get_template (the web editor loads it into its Render data panel). It does not change what render_template uses without `data`: that is the DSL's own `const sampleData`. `null` clears the stored value; omit to leave it un… |
| templateId * | string | Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows. |
| description | ["string","null"] | New one-sentence summary. Pass `null` to clear the stored value; omit the key entirely to leave it unchanged. |
{
"name": "update_template",
"title": "Update template",
"description": "Update a saved template's DSL, name, description, and/or sampleData. Revalidates the DSL when provided. A DSL that differs from the stored one is recorded in the template's revision history (History tab on /templates/:id); sending the same DSL again records nothing, and name, description and sampleData are overwritten without history. For `description` and `sampleData`: pass `null` to clear; omit to leave unchanged. Returns { templateId, name, updatedAt }. Mirrors PUT /api/v1/templates/:id.",
"inputSchema": {
"type": "object",
"required": [
"templateId"
],
"properties": {
"dsl": {
"type": "string",
"description": "Replacement builder DSL script; it is validated before saving. Omit to keep the current DSL. Up to 512KB."
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "New display name. Omit to keep the current name."
},
"sampleData": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"description": "Replacement sample binding data, stored alongside the template and returned by get_template (the web editor loads it into its Render data panel). It does not change what render_template uses without `data`: that is the DSL's own `const sampleData`. `null` clears the stored value; omit to leave it unchanged."
},
"templateId": {
"type": "string",
"description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows."
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 280,
"description": "New one-sentence summary. Pass `null` to clear the stored value; omit the key entirely to leave it unchanged."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"templateId",
"name",
"updatedAt"
],
"properties": {
"name": {
"type": "string",
"description": "The display name after the update."
},
"updatedAt": {
"type": "string",
"description": "When the template was changed, as a UTC 'YYYY-MM-DD HH:MM:SS' timestamp."
},
"templateId": {
"type": "string",
"description": "Template ID: a slug for library templates, a UUID for your own."
}
}
},
"annotations": {
"title": "Update template",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Permanently delete a caller-owned template by ID. This cannot be undone. Library rows cannot be deleted. Returns JSON { templateId, deleted: true }. Mirrors DELETE /api/v1/templates/:id.
| Parameter | Type | Description |
|---|---|---|
| templateId * | string | Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows. |
{
"name": "delete_template",
"title": "Delete template",
"description": "Permanently delete a caller-owned template by ID. This cannot be undone. Library rows cannot be deleted. Returns JSON { templateId, deleted: true }. Mirrors DELETE /api/v1/templates/:id.",
"inputSchema": {
"type": "object",
"required": [
"templateId"
],
"properties": {
"templateId": {
"type": "string",
"description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"templateId",
"deleted"
],
"properties": {
"deleted": {
"type": "boolean",
"const": true,
"description": "Always true; a failed delete is a tool error."
},
"templateId": {
"type": "string",
"description": "Template ID: a slug for library templates, a UUID for your own."
}
}
},
"annotations": {
"title": "Delete template",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Re-issue a short-lived signed download URL for a render artifact the caller owns, so a PDF rendered in an earlier turn can be downloaded without the embedded base64 bytes. Free (no credits). Returns JSON { artifactId, downloadUrl, downloadUrlExpiresAt } and a resource_link to the URL. Owner-scoped; links follow the artifact's normal retention. An unknown, unowned, failed or expired artifact returns the same 'Render not found' error.
| Parameter | Type | Description |
|---|---|---|
| artifactId * | string | UUID of the render artifact — the `artifactId` returned by a render tool, or the `X-Artifact-Id` response header on a REST render. |
{
"name": "get_render_download_url",
"title": "Get render download URL",
"description": "Re-issue a short-lived signed download URL for a render artifact the caller owns, so a PDF rendered in an earlier turn can be downloaded without the embedded base64 bytes. Free (no credits). Returns JSON { artifactId, downloadUrl, downloadUrlExpiresAt } and a resource_link to the URL. Owner-scoped; links follow the artifact's normal retention. An unknown, unowned, failed or expired artifact returns the same 'Render not found' error.",
"inputSchema": {
"type": "object",
"required": [
"artifactId"
],
"properties": {
"artifactId": {
"type": "string",
"maxLength": 64,
"description": "UUID of the render artifact — the `artifactId` returned by a render tool, or the `X-Artifact-Id` response header on a REST render."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"artifactId",
"downloadUrl",
"downloadUrlExpiresAt"
],
"properties": {
"artifactId": {
"type": "string",
"description": "The artifact the link downloads."
},
"downloadUrl": {
"type": "string",
"description": "Short-lived signed URL that downloads the PDF with no credential of its own."
},
"downloadUrlExpiresAt": {
"type": "string",
"description": "When `downloadUrl` stops working, as an ISO 8601 timestamp."
}
}
},
"annotations": {
"title": "Get render download URL",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Send feedback about this MCP server to the makesPDF team: a tool failure you could not explain, an error message or tool description that was wrong or misleading, a capability that is missing, or a concrete suggestion. The summary is the problem in your own words (what you were trying to do, what you tried, what you expected); it must not contain the user's document text, markdown, DSL source or data values, and a specific render is identified by its artifactId instead. Read by the makesPDF team; nobody replies in real time. Free: no credits are used and the user's renders are unaffected.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | `stuck` — a tool failed and you could not work out why; `bug` — something behaved incorrectly (a misleading error/description counts); `suggestion` — a missing capability or a concrete improvement. |
| summary * | string | The problem in your own words: what you were doing, what you tried, and what you expected. Describe it rather than pasting the user's document text, markdown, DSL or data. |
| toolName | string | Optional name of the tool this concerns (e.g. `render_template`). |
| artifactId | string | Optional UUID of the render artifact this concerns (the `artifactId` returned by a render call or the `X-Artifact-Id` response header). |
{
"name": "report_feedback",
"title": "Send feedback to makesPDF",
"description": "Send feedback about this MCP server to the makesPDF team: a tool failure you could not explain, an error message or tool description that was wrong or misleading, a capability that is missing, or a concrete suggestion. The summary is the problem in your own words (what you were trying to do, what you tried, what you expected); it must not contain the user's document text, markdown, DSL source or data values, and a specific render is identified by its artifactId instead. Read by the makesPDF team; nobody replies in real time. Free: no credits are used and the user's renders are unaffected.",
"inputSchema": {
"type": "object",
"required": [
"kind",
"summary"
],
"properties": {
"kind": {
"enum": [
"stuck",
"bug",
"suggestion"
],
"type": "string",
"description": "`stuck` — a tool failed and you could not work out why; `bug` — something behaved incorrectly (a misleading error/description counts); `suggestion` — a missing capability or a concrete improvement."
},
"summary": {
"type": "string",
"maxLength": 2000,
"minLength": 10,
"description": "The problem in your own words: what you were doing, what you tried, and what you expected. Describe it rather than pasting the user's document text, markdown, DSL or data."
},
"toolName": {
"type": "string",
"maxLength": 64,
"description": "Optional name of the tool this concerns (e.g. `render_template`)."
},
"artifactId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "Optional UUID of the render artifact this concerns (the `artifactId` returned by a render call or the `X-Artifact-Id` response header)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"feedbackId",
"recorded"
],
"properties": {
"recorded": {
"type": "boolean",
"const": true,
"description": "Always true; a failed submission is a tool error."
},
"feedbackId": {
"type": "string",
"description": "UUID of the stored feedback row."
}
}
},
"annotations": {
"title": "Send feedback to makesPDF",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}makesPDF creates PDF documents. When the user wants a PDF of written content (notes, reports, summaries, letters, lists, checklists, flowcharts and other diagrams), compose it as markdown and call `render_markdown`. It supports GitHub-flavored markdown, tables, task lists, Mermaid diagrams, code highlighting and images, and produces a tagged, accessible PDF (PDF/UA-1 + PDF/A-2A). `validate_markdown` (free) checks headings and alt text first; there is no markdown preview. When the user wants a PDF invoice, receipt, quote, certificate or resume, `list_templates` finds a curated template (`owner: 'library'`, or filter by `category`, `tags`, `q`); call `render_template` with its `templateId` and the user's data. `get_template` returns a template's DSL and sampleData. `render_markdown` and `render_template` use the user's makesPDF credits: 1 credit per 10 pages (the Free plan includes 10 a month). `render_dsl_preview` is free but every page is stamped 'PREVIEW — NOT FOR USE': use it while designing a custom template, then deliver the document with `render_template`. **Saving a rendered PDF:** `render_markdown` and `render_template` return a `downloadUrl` that needs no credentials (`curl -o document.pdf '<downloadUrl>'`). Download it; do not rebuild the PDF from the embedded blob. It expires after 15 minutes; `get_render_download_url` with the `artifactId` mints a fresh one. **Custom templates:** before authoring DSL, read the resource `file:///skills/pdf-template-author.md` once per session. Loop: write DSL → `validate_dsl` → `render_dsl_preview` → `save_template` → `render_template`. Stuck, or a description misled you? `report_feedback` (free) reaches the makesPDF team; never include the user's document text, markdown, DSL or data values.
Names, descriptions and schemas were written by the server and are shown as data.