_ registry / mcp streamable-http · checked 48m ago

makespdf-mcp

https://makespdf.com

Registry code: a99b31bae6a0662b

api record

makesPDF authoring tools.

**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.

endpoint
https://makespdf.com/api/v1/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is makespdf-mcp live?
Yes — it answered the hub's last check (checked 48m ago). It answered 98% of checks over the last 30 days.
Is makespdf-mcp free to use?
Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
What tools does makespdf-mcp have?
11 tools: validate_markdown, render_template, get_template, render_markdown, report_feedback, update_template, validate_dsl, render_dsl_preview, ….
Is makespdf-mcp safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
98.4%

90 days 99%· all time 99%

latency
2,114ms

last good check

priced tools
0

of 11 tools

_ answered our checks, 90 days 400 checks · signed record
  • degraded → live
  • live → degraded· timeout after 20000ms
  • degraded → live
  • live → degraded· fetch failed
  • degraded → live
_ what it is for
topic
documents & files generation & templates
used for
  • render markdown to pdf
  • render a pdf template with data
  • validate a pdf template
  • save and update pdf templates
takes → gives
text, data → documents, data
tools
7 reads3 changes data1 sends messages
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts, and USDC settlements on base into the address this listing's priced doors name, read off the chain. Every caller and every payer counts the same; the chain total is counted from three payers. The address stands behind 3 doors on this origin, so the chain figures are the operator's. How it is counted.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

payers on base
1

distinct

settlements
1

last 2026-10-20

received on chain
0.01 USDC

counted from three payers (thin, concentrated)

_ what it can do 11 tools
11 auth-required 11 of 11 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • validate_markdown reads auth-required never probed

    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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 12 lines
  • render_template reads auth-required never probed

    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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 21 lines
  • get_template reads auth-required 44d ago

    Fetch a single template (library or caller-owned) by ID, including its full DSL source and sampleData. Mirrors GET /api/v1/templates/:id.

    mcp-tool

    {
  "type": "object",
  "required": [
    "templateId"
  ],
  "properties": {
    "templateId": {
      "type": "string",
      "description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows."
    }
  }
}
    arguments 12 lines
  • render_markdown reads auth-required never probed

    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.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 111 lines
  • report_feedback sends messages auth-required never probed

    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.

    mcp-tool

    {
  "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
}
    arguments 35 lines
  • update_template changes data auth-required never probed

    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.

    mcp-tool

    {
  "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": {
      "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."
    }
  }
}
    arguments 33 lines
  • validate_dsl reads auth-required never probed

    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.

    mcp-tool

    {
  "type": "object",
  "required": [
    "dsl"
  ],
  "properties": {
    "dsl": {
      "type": "string",
      "description": "The builder DSL script to validate. Must define a template (see skills/pdf-template-author.md)."
    },
    "data": {
      "type": "object",
      "description": "Optional binding data. Falls back to the script's sampleData when omitted."
    }
  }
}
    arguments 16 lines
  • render_dsl_preview reads auth-required never probed

    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.

    mcp-tool

    {
  "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 = {...}`. The builder functions are documented in the pdf-template-author skill; run validate_dsl on the script first."
    },
    "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."
    }
  }
}
    arguments 21 lines
  • save_template changes data auth-required never probed

    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 }.

    mcp-tool

    {
  "type": "object",
  "required": [
    "dsl",
    "name"
  ],
  "properties": {
    "dsl": {
      "type": "string",
      "description": "The builder DSL script to store, normally one that has passed validate_dsl. Up to 512KB."
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Display name shown in list_templates results and on the /templates page."
    },
    "sampleData": {
      "description": "Optional JSON binding data to persist alongside the template. Round-tripped on get_template / modify-template flow."
    },
    "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`."
    }
  }
}
    arguments 27 lines
  • delete_template changes data auth-required never probed

    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.

    mcp-tool

    {
  "type": "object",
  "required": [
    "templateId"
  ],
  "properties": {
    "templateId": {
      "type": "string",
      "description": "Template ID — slug for library rows (e.g. 'invoice-classic') or UUID for user rows."
    }
  }
}
    arguments 12 lines
  • list_templates reads auth-required 44d ago

    List templates visible to the caller: the curated makesPDF library and the caller's own saved templates. Returns metadata only and one page at a time; fetch a template's DSL with get_template, or render it directly with render_template. Browse the library here before authoring a template from scratch. Mirrors GET /api/v1/templates.

    mcp-tool

    {
  "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."
    }
  }
}
    arguments 43 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id a99b31bae6a0662b.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/a99b31bae6a0662b/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/a99b31bae6a0662b/badge.svg)](https://brick.blue/agent/a99b31bae6a0662b?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.