Server definition

Hash: sha256:e1db0836aa65a29a9575bff1d629374e6a157ff47bf78dec5b02460ebe9a385e
What it is: What a remote MCP server returned when asked what it offers: 11 tools

The blob, as servednamed by its sha256

{
  "instructions": "makesPDF authoring tools.\n\n**Before authoring any template, read the resource `file:///skills/pdf-template-author.md` once per session** — it is the canonical DSL reference (builder functions, style properties, nesting rules, recipes). Do not guess DSL syntax; read the skill first.\n\nAuthoring loop: write DSL → call `validate_dsl` → fix any reported errors → call `render_dsl_preview` to confirm the layout. Use `save_template` to persist the final version, then `render_template` to produce the real (billed) PDF.\n\n**Before authoring from scratch, browse the curated library first** with `list_templates` (use `owner: 'library'` or filter by `category`, `tags`, or free-text `q`). Fetch a candidate with `get_template` to get its DSL + sampleData. You can render library `templateId`s directly through `render_template` — there's no fork-first step. Customising? Pull the DSL, edit locally, `save_template` for a user-owned copy.\n\nAll tools are free (no credits consumed) **except** `render_template`, which charges 1 credit per 10 pages and produces a real (non-watermarked on paid plans) PDF. Use `render_dsl_preview` for free, watermarked previews while iterating; only call `render_template` once the layout is confirmed. Markdown has its own billed tool, `render_markdown` (same 1 credit / 10 pages rate). Run `validate_markdown` first - it is free. There is no free markdown preview: markdown needs no layout iteration, so `render_markdown` is the only markdown render tool.\n\nIf you get stuck — a tool failed and you cannot work out why, an error or description misled you, or a capability you needed is missing — call `report_feedback` (free) and say so in your own words. It is read by the makesPDF team; nobody replies in real time. Never include the user's document text, markdown, DSL source or data values; describe the problem or pass the render's artifactId instead.",
  "tools": [
    {
      "description": "Delete a caller-owned template by ID. Library rows cannot be deleted. Mirrors DELETE /api/v1/templates/:id.",
      "inputSchema": {
        "properties": {
          "templateId": {
            "description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows.",
            "type": "string"
          }
        },
        "required": [
          "templateId"
        ],
        "type": "object"
      },
      "name": "delete_template",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "templateId": {
            "description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows.",
            "type": "string"
          }
        },
        "required": [
          "templateId"
        ],
        "type": "object"
      },
      "name": "get_template",
      "outputSchema": null
    },
    {
      "description": "List templates visible to the caller — both curated library templates (no owner) and the caller's own saved templates. Metadata only (no DSL bodies). Paginated. Use `owner: 'mine'` to restrict to your own; `owner: 'library'` for the curated catalog only; default `'all'` returns both. Optional `category`, `tags` (comma-separated, ANDed), and `q` (free-text over name + description) filters apply across both. Mirrors GET /api/v1/templates.",
      "inputSchema": {
        "properties": {
          "category": {
            "maxLength": 64,
            "type": "string"
          },
          "limit": {
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "default": 0,
            "minimum": 0,
            "type": "integer"
          },
          "owner": {
            "default": "all",
            "enum": [
              "mine",
              "library",
              "all"
            ],
            "type": "string"
          },
          "q": {
            "maxLength": 128,
            "type": "string"
          },
          "tags": {
            "maxLength": 256,
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_templates",
      "outputSchema": null
    },
    {
      "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. Mirrors POST /api/v1/preview.",
      "inputSchema": {
        "properties": {
          "data": {
            "description": "Optional binding data. Falls back to the script's sampleData when omitted.",
            "type": "object"
          },
          "dsl": {
            "description": "The builder DSL script.",
            "type": "string"
          },
          "title": {
            "description": "Optional document title (shown in PDF metadata).",
            "maxLength": 200,
            "type": "string"
          }
        },
        "required": [
          "dsl"
        ],
        "type": "object"
      },
      "name": "render_dsl_preview",
      "outputSchema": null
    },
    {
      "description": "Render GitHub-flavored markdown to a real PDF (PDF/A-2A + PDF/UA-1 dual-compliant, tagged). **BILLED - consumes credits at the rate of 1 credit per 10 pages.** Returns JSON metadata (pageCount, creditsDeducted, creditsRemaining, artifactId) plus the PDF bytes as an embedded base64 resource. On the free plan the PDF is watermarked; paid plans render clean. Mirrors POST /api/v1/md. Run `validate_markdown` first - it is free and catches heading-hierarchy and alt-text problems before you pay to render them. There is no free markdown preview: markdown needs no layout iteration, so this is the only markdown render tool.",
      "inputSchema": {
        "properties": {
          "markdown": {
            "description": "GitHub-flavored markdown source. Max 200KB of text; inline data: image payloads are excluded from that budget.",
            "type": "string"
          },
          "options": {
            "description": "Optional render settings. Anything omitted falls back to YAML frontmatter in the markdown, then to the runtime default.",
            "properties": {
              "author": {
                "description": "PDF /Author metadata.",
                "maxLength": 200,
                "type": "string"
              },
              "fontFamily": {
                "enum": [
                  "Inter",
                  "NotoSans"
                ],
                "type": "string"
              },
              "fontSize": {
                "maximum": 24,
                "minimum": 6,
                "type": "number"
              },
              "keywords": {
                "description": "PDF /Keywords metadata.",
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "margins": {
                "description": "Page margins in points, [top, right, bottom, left].",
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              "pageSize": {
                "enum": [
                  "A3",
                  "A4",
                  "A5",
                  "Letter",
                  "Legal"
                ],
                "type": "string"
              },
              "splitMode": {
                "enum": [
                  "default",
                  "balanced"
                ],
                "type": "string"
              },
              "subject": {
                "description": "PDF /Subject metadata.",
                "maxLength": 200,
                "type": "string"
              },
              "theme": {
                "enum": [
                  "default",
                  "github"
                ],
                "type": "string"
              },
              "title": {
                "description": "Optional document title (shown in PDF metadata).",
                "maxLength": 200,
                "type": "string"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "markdown"
        ],
        "type": "object"
      },
      "name": "render_markdown",
      "outputSchema": null
    },
    {
      "description": "Render any readable template (curated library row or caller-owned) to a real PDF. **BILLED — consumes credits at the rate of 1 credit per 10 pages.** Returns JSON metadata (pageCount, creditsDeducted, creditsRemaining, artifactId) plus the PDF bytes as an embedded base64 resource. On the free plan the PDF is watermarked; paid plans render clean. Mirrors POST /api/v1/render with the { templateId, data } body shape. Use `render_dsl_preview` first to confirm the layout — that's free and watermarked. Only call this once you're confident the template is right.",
      "inputSchema": {
        "properties": {
          "data": {
            "description": "Binding data substituted into {{var}} expressions. Falls back to the template's sampleData when omitted.",
            "type": "object"
          },
          "templateId": {
            "description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows.",
            "type": "string"
          },
          "title": {
            "description": "Optional document title (shown in PDF metadata).",
            "maxLength": 200,
            "type": "string"
          }
        },
        "required": [
          "templateId"
        ],
        "type": "object"
      },
      "name": "render_template",
      "outputSchema": null
    },
    {
      "description": "Report feedback about this MCP server to the makesPDF team — where you got stuck, a tool error or description that misled you, a capability you needed but could not find, or a concrete suggestion for the server. Call it after a tool failed and you could not work out why, when an error message or tool description contradicted the skill file, when something you needed is missing, or when you have a specific improvement in mind. Write the problem in your own words: what you were trying to do, what you tried, and what you expected to happen. Do not include the user's document text, markdown, DSL source or data values. Describe the problem instead; if it concerns a specific render, pass its artifactId. This is not a support channel — nobody replies in real time. Calling it is free: it does not consume credits and does not affect the user's renders.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "artifactId": {
            "description": "Optional UUID of the render artifact this concerns (the `artifactId` returned by a render call or the `X-Artifact-Id` response header).",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
            "type": "string"
          },
          "kind": {
            "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.",
            "enum": [
              "stuck",
              "bug",
              "suggestion"
            ],
            "type": "string"
          },
          "summary": {
            "description": "The problem in your own words: what you tried and what you expected. Do not include document content (see the content rule above).",
            "maxLength": 2000,
            "minLength": 10,
            "type": "string"
          },
          "toolName": {
            "description": "Optional name of the tool this concerns (e.g. `render_template`).",
            "maxLength": 64,
            "type": "string"
          }
        },
        "required": [
          "kind",
          "summary"
        ],
        "type": "object"
      },
      "name": "report_feedback",
      "outputSchema": null
    },
    {
      "description": "Save a user-owned DSL template for later reuse via /api/v1/render. Validates the DSL with the catalog before persisting. Free (no credits). Pass `sampleData` (any JSON value) so the template's binding shape is preserved — the modify-template flow on /ai/chat round-trips this back into the Render data panel when the user returns. Optional `description` is a one-sentence summary surfaced on /templates. Returns { templateId, name, createdAt }.",
      "inputSchema": {
        "properties": {
          "description": {
            "description": "Optional one-sentence summary (max 280 chars). Surfaced on /templates list rows.",
            "maxLength": 280,
            "type": "string"
          },
          "dsl": {
            "description": "The builder DSL script (<=512KB).",
            "type": "string"
          },
          "name": {
            "description": "Human-readable template name.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "sampleData": {
            "description": "Optional JSON binding data to persist alongside the template. Round-tripped on get_template / modify-template flow."
          }
        },
        "required": [
          "dsl",
          "name"
        ],
        "type": "object"
      },
      "name": "save_template",
      "outputSchema": null
    },
    {
      "description": "Update a saved template's DSL, name, description, and/or sampleData. Revalidates the DSL when provided. For `description` and `sampleData`: pass `null` to clear; omit to leave unchanged. Mirrors PUT /api/v1/templates/:id.",
      "inputSchema": {
        "properties": {
          "description": {
            "description": "Optional one-sentence summary (max 280 chars). Pass `null` (instead of a string) to clear the stored value; omit the key entirely to leave it unchanged.",
            "maxLength": 280,
            "type": [
              "string",
              "null"
            ]
          },
          "dsl": {
            "description": "Replacement builder DSL script (<=512KB).",
            "type": "string"
          },
          "name": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "sampleData": {
            "description": "Optional JSON binding data. `null` clears the stored value; omit to leave unchanged."
          },
          "templateId": {
            "description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows.",
            "type": "string"
          }
        },
        "required": [
          "templateId"
        ],
        "type": "object"
      },
      "name": "update_template",
      "outputSchema": null
    },
    {
      "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. Mirrors POST /api/v1/preview/validate.",
      "inputSchema": {
        "properties": {
          "data": {
            "description": "Optional binding data. Falls back to the script's sampleData when omitted.",
            "type": "object"
          },
          "dsl": {
            "description": "The builder DSL script to validate. Must define a template (see skills/pdf-template-author.md).",
            "type": "string"
          }
        },
        "required": [
          "dsl"
        ],
        "type": "object"
      },
      "name": "validate_dsl",
      "outputSchema": null
    },
    {
      "description": "Validate a markdown document for PDF/UA-1 accessibility issues (heading hierarchy, missing alt text). Cheap — no rendering. Mirrors POST /api/v1/md/validate.",
      "inputSchema": {
        "properties": {
          "markdown": {
            "description": "GitHub-flavored markdown source. Max 200KB of text; inline data: image payloads are excluded from that budget.",
            "type": "string"
          }
        },
        "required": [
          "markdown"
        ],
        "type": "object"
      },
      "name": "validate_markdown",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:e1db0836aa65a29a9575bff1d629374e6a157ff47bf78dec5b02460ebe9a385e | sha256sum