Integrate makesPDF into your app

# Write your DSL to a file, then save it and capture the templateId
jq -n --rawfile dsl template.js --arg name "Invoice v1" \
  '{ dsl: $dsl, name: $name }' |
  curl -sX POST https://makespdf.com/api/v1/templates \
    -H "Authorization: Bearer $MAKESPDF_API_KEY" \
    -H "Content-Type: application/json" \
    --data-binary @-
# -> { "templateId": "11111111-2222-...", "name": "Invoice v1", "createdAt": ... }

# Store it as config, e.g. MAKESPDF_INVOICE_TEMPLATE_ID=11111111-2222-...

export async function renderInvoice(data: unknown): Promise<Uint8Array> {
  const res = await fetch("https://makespdf.com/api/v1/render", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MAKESPDF_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      templateId: process.env.MAKESPDF_INVOICE_TEMPLATE_ID,
      data,
    }),
  });
  if (!res.ok) {
    throw new Error(`makesPDF ${res.status}: ${await res.text()}`);
  }
  return new Uint8Array(await res.arrayBuffer());
}

claude mcp add --transport http makespdf \
  https://makespdf.com/api/v1/mcp \
  --header "Authorization: Bearer mpdf_your_api_key"

curl -X POST https://makespdf.com/api/v1/mcp \
  -H "Authorization: Bearer mpdf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# -> JSON listing all eleven tools (validate_dsl, render_dsl_preview, ...)

Create an invoice template for Acme Corp with 3 line items, save it, and
show me the preview PDF.

// skill.ts — fetch the canonical skill live; fall back to the vendored copy.
const SKILL_URL = "https://makespdf.com/skills/pdf-template-author.md";
let cached: string | null = null;

export async function getSkill(fallback?: string): Promise<string> {
  if (cached) return cached;
  try {
    const res = await fetch(SKILL_URL);
    if (!res.ok) throw new Error(`skill fetch ${res.status}`);
    cached = await res.text();
    return cached;
  } catch (err) {
    // Offline / deploy-frozen fallback: vendor once with
    //   curl -o pdf-template-author.md https://makespdf.com/skills/pdf-template-author.md
    // and pass its contents as `fallback`.
    if (fallback) {
      cached = fallback;
      return cached;
    }
    throw err;
  }
}

// makespdf-tools.ts — REST-only tools() shim (BYOK; no proxy, no billing passthrough).
import { tool } from "ai";
import { z } from "zod";

const dataSchema = z.record(z.string(), z.unknown()).optional();

export function makespdfTools(opts: { apiKey: string; baseUrl?: string }) {
  const base = (opts.baseUrl ?? "https://makespdf.com").replace(/\/$/, "");
  const headers = {
    Authorization: `Bearer ${opts.apiKey}`,
    "Content-Type": "application/json",
  };
  const post = async (path: string, body: unknown) => {
    const res = await fetch(`${base}${path}`, {
      method: "POST",
      headers,
      body: JSON.stringify(body),
    });
    if (!res.ok) throw new Error(`makesPDF ${res.status}: ${await res.text()}`);
    return res;
  };

  return {
    validate_dsl: tool({
      description: "Catalog + accessibility check for a DSL script. Cheap, no render.",
      inputSchema: z.object({ dsl: z.string(), data: dataSchema }),
      execute: async ({ dsl, data }) =>
        post("/api/v1/preview/validate", { dsl, data }).then((r) => r.json()),
    }),
    render_dsl_preview: tool({
      description: "Free watermarked preview PDF. Returns { pageCount, pdfBase64 }.",
      inputSchema: z.object({ dsl: z.string(), data: dataSchema }),
      execute: async ({ dsl, data }) => {
        const res = await post("/api/v1/preview", { dsl, data });
        const buf = Buffer.from(await res.arrayBuffer());
        return {
          pageCount: Number(res.headers.get("x-pages") ?? 0),
          pdfBase64: buf.toString("base64"),
        };
      },
    }),
    render_template: tool({
      description: "BILLED (1 credit / 10 pages). Render a saved templateId to a real PDF.",
      inputSchema: z.object({ templateId: z.string(), data: dataSchema }),
      execute: async ({ templateId, data }) => {
        const res = await post("/api/v1/render", { templateId, data });
        const buf = Buffer.from(await res.arrayBuffer());
        return {
          pageCount: Number(res.headers.get("x-pages") ?? 0),
          creditsDeducted: Number(res.headers.get("x-credits-deducted") ?? 0),
          pdfBase64: buf.toString("base64"),
        };
      },
    }),
  };
}

import { generateText } from "ai";
import { getSkill } from "./skill";
import { makespdfTools } from "./makespdf-tools";

const skill = await getSkill(); // or getSkill(vendoredFallbackText)
const { text } = await generateText({
  model: YOUR_MODEL, // your key, your account — makesPDF never proxies LLM calls
  system: skill + "\n\n" + "Use validate_dsl before every preview; only call render_template when the layout is confirmed.",
  tools: makespdfTools({ apiKey: process.env.MAKESPDF_API_KEY! }),
  prompt: "Create an invoice template for Acme Corp with 3 line items.",
});