Platemark

Crea facturas, presupuestos y recibos en PDF con cálculos exactos al céntimo, además de certificados, cartas, imágenes para redes sociales y videos cortos. Servidor remoto con una herramienta de registro de agentes.

Servidor MCP alojado

npx add-mcp 'https://platemark.rowhousesoftware.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Docs

The API lives at https://platemark.rowhousesoftware.com/v1. It takes JSON and returns PNGs and PDFs. You can try it with no key at all.

Quick start

# Try it first, no key (3 a day, with the watermark)
curl https://platemark.rowhousesoftware.com/v1/charts -H "Content-Type: application/json" \
  -d '{"type": "bar", "title": "Signups", "labels": ["Mon", "Tue", "Wed", "Thu"], "values": [12, 19, 15, 22]}' > chart.png

# 1. Get a key (or use the form on the home page)
curl https://platemark.rowhousesoftware.com/v1/accounts -H "Content-Type: application/json" -d '{"email": "you@company.com"}'

# 2. Make an image
curl https://platemark.rowhousesoftware.com/v1/images \
  -H "Authorization: Bearer pm_..." -H "Content-Type: application/json" \
  -d '{"template": "quote-card-square", "modifications": {"quote": "Done beats perfect.", "author": "Sam Lee"}}' \
  > quote.png

Keys

POST /v1/accounts with {"email": "..."} makes an account and returns its first key. The key is shown once. Send it on every call as Authorization: Bearer pm_....

GET /v1/account tells you your plan and how many credits are left.

Trying it without a key

Leave the Authorization header off and every render endpoint except video still works, 3 times a day per IP address. Those files carry the watermark and the response has an x-trial-left header. After the third you get a 429 trial_limit that says how to get a key. Video always needs a key. So does everything else.

Make an image

POST /v1/images

templateA template id, like og-image.
modificationsAn object keyed by slot name. Leave out a slot to keep its sample.
responseOptional. "json" returns {"data_url": "data:image/png;base64,...", "credits_left": 99} instead of the raw PNG. Handy in n8n and Make.

The raw response is image/png, with an x-credits-left header.

JavaScript

const res = await fetch("https://platemark.rowhousesoftware.com/v1/images", {
  method: "POST",
  headers: { Authorization: \`Bearer ${process.env.PLATEMARK_KEY}\`, "Content-Type": "application/json" },
  body: JSON.stringify({ template: "product-card-square", modifications: { name: "Linen apron", price: "$34", photo: imageUrl } }),
});
const png = Buffer.from(await res.arrayBuffer());

Python

import os, requests
r = requests.post("https://platemark.rowhousesoftware.com/v1/images",
    headers={"Authorization": f"Bearer {os.environ['PLATEMARK_KEY']}"},
    json={"template": "og-image", "modifications": {"title": "Our 2026 pricing, explained"}})
open("og.png", "wb").write(r.content)

Make a video

POST /v1/videos queues a vertical (or any template size) MP4 made from scenes. Each scene is a template with its slots, or just a photo URL. You get a job id back right away.

curl https://platemark.rowhousesoftware.com/v1/videos -H "Authorization: Bearer pm_..." -H "Content-Type: application/json" -d '{
  "scenes": [
    {"template": "just-listed-story", "modifications": {"price": "$489,000"}, "seconds": 4, "motion": "zoom_in"},
    {"image_url": "https://example.com/kitchen.jpg", "seconds": 3, "motion": "pan_right"},
    {"image_url": "https://example.com/yard.jpg", "seconds": 3, "motion": "zoom_out"}
  ],
  "transition": "fade",
  "audio_url": "https://example.com/music.mp3",
  "webhook_url": "https://example.com/hooks/platemark"
}'
  • Up to 20 scenes and 90 seconds. Each scene runs 1 to 30 seconds.
  • Motion is none, zoom_in, zoom_out, pan_left or pan_right. Transitions are fade or cut.
  • Audio is an https MP3, M4A, AAC or WAV under 20 MB. It's trimmed to the video and fades out at the end.
  • Video costs 0.5 credits a second, charged when you submit and refunded if the render fails. A 30 second video is 15 credits.

Check on it with GET /v1/videos/{id}, or wait for the webhook. Status goes queued, rendering, then done with a url, or failed with an error. Files stay up for 30 days. A short video usually takes 15 to 40 seconds.

Make a PDF

POST /v1/documents makes an invoice, quote, receipt, certificate or letter as a PDF. Send money as plain numbers. Platemark does every sum in exact cents and formats it for the currency and locale, so the PDF and the totals it returns always match.

curl https://platemark.rowhousesoftware.com/v1/documents -H "Authorization: Bearer pm_..." -H "Content-Type: application/json" -d '{
  "type": "invoice",
  "response": "json",
  "from": {"name": "Harbor Design Co.", "address": "1120 Thames Street, Baltimore, MD 21231", "email": "billing@harbordesign.co"},
  "to": {"name": "Ledgerline, Inc.", "address": "44 Wharf Road, Boston, MA 02110"},
  "number": "INV-1042",
  "due_days": 30,
  "items": [
    {"description": "Brand refresh", "unit_price": 2800},
    {"description": "Website design", "quantity": 24, "unit_price": 65}
  ],
  "discount": {"percent": 5},
  "tax": {"percent": 6, "label": "Sales tax (6%)"},
  "amount_paid": 1000
}'

With "response": "json" you get {"url", "pages", "credits", "totals": {...}}, with subtotal, discount, tax, shipping, total, amount_paid and amount_due. Without it you get the PDF itself. Either way the file stays at its URL for 30 days.

invoicefrom, to, items [{description, detail, quantity, unit_price}], number, issue_date, due_date or due_days, po_number, currency, locale, discount {percent or amount}, tax {percent or amount, label}, shipping, amount_paid, payment_instructions, notes, terms, accent, paper (letter or a4)
quoteThe invoice fields, plus valid_until or valid_days (default 30). No amount due.
receiptThe invoice fields, plus paid_date and payment_method. Marked Paid.
certificatetitle, recipient, reason, kicker, presented, signatures [{name, role}] (up to 2), date, id, accent
letterfrom, to, subject, body (paragraphs split by blank lines), closing, signer, signer_role, date, footer

A document costs 2 credits, plus 1 for each page past the second. AI agents can use the render_invoice and render_document MCP tools instead. Tax applies after the discount, and amounts round half up to the cent.

Make a chart

POST /v1/charts turns numbers into a chart PNG: bar, horizontal_bar, stacked_bar, line, area, pie or donut. Axis ticks, number formats and label spacing are handled for you.

curl https://platemark.rowhousesoftware.com/v1/charts -H "Authorization: Bearer pm_..." -H "Content-Type: application/json" -d '{
  "type": "bar",
  "title": "Monthly revenue",
  "subtitle": "USD, first half of 2026",
  "format": "currency",
  "labels": ["Jan", "Feb", "Mar", "Apr", "May", "Jun"],
  "values": [12400, 15800, 14200, 19900, 23100, 27600],
  "highlight": "Jun",
  "response": "json"
}'

With "response": "json" you get {"url", "alt_text", "width", "height", "credits_left"}. The link is kept for a year, so it's safe in emails and docs. alt_text is one sentence describing the data. Without it you get the PNG, with the link in the x-file-url header. "response": "svg" returns the SVG.

labels, valuesOne label per value. For several series, send series: [{name, values}] instead (up to 8). null leaves a gap in a line.
formatnumber, currency (with currency, like EUR) or percent (12.5 means 12.5%). Add locale and decimals if you need them.
highlightA label to emphasize. Its bar or slice keeps its color and the rest go gray.
sizelandscape 1200x675 (default), og 1200x630, square, portrait, story, or width and height from 300 to 2400.
theme, colorslight or dark. colors overrides the series colors in order, as hex.
source, show_values, y_min, y_maxA footnote, value labels forced on or off, and a fixed value axis.

A chart costs 1 credit. Pies and donuts show up to 6 slices and fold the rest into Other. AI agents can use the render_chart MCP tool. There's a free chart maker for one-offs.

Filling slots

A slot takes a plain string, or an object when you want more:

"modifications": {
  "title": "Plain text",
  "photo": "https://example.com/photo.jpg",
  "badge": { "text": "Sold", "bg": "#15803d" },
  "headline": { "text": "Big news", "color": "#fde68a" },
  "background": { "color": "#0f172a" }
}
  • Text shrinks to fit its box and wraps on its own. Line breaks you send are kept.
  • Images must be https PNG, JPG or GIF under 4 MB. They fill their box and crop from the center.
  • An empty pill slot ("") disappears instead of leaving a blank shape.

AI agents (MCP)

Platemark is an MCP server at https://platemark.rowhousesoftware.com/mcp. Add it to Claude, Cursor or any MCP client as a remote (HTTP) server, with your key as a header:

{
  "mcpServers": {
    "platemark": {
      "type": "http",
      "url": "https://platemark.rowhousesoftware.com/mcp",
      "headers": { "Authorization": "Bearer pm_..." }
    }
  }
}

The tools are render_chart, render_invoice, render_document, list_templates, render_image, render_video, video_status, account_status and create_account. With no key, an agent still gets 3 watermarked renders a day, so its first call works. To get past that it calls create_account with your email and you add the key to the config. Videos take a little while, so render_video returns a job id and the agent checks video_status until it's done.

Signed URLs for link previews

For an og:image tag you want a plain URL, not a POST. Sign the query with your signing secret and any crawler can load it. The first load renders and costs a credit. After that it's served from cache, free.

import crypto from "crypto";
const account = "acct_...";                           // "account" from GET /v1/account
const secret = process.env.PLATEMARK_SIGNING_SECRET;  // "signing_secret" from the same call
const params = new URLSearchParams({ a: account, title: "How we closed the books in 2 days" });
params.sort();
const s = crypto.createHmac("sha256", secret).update(\`og-image?${params}\`).digest("hex").slice(0, 32);
const url = \`https://platemark.rowhousesoftware.com/v1/images/og-image.png?${params}&s=${s}\`;

Keep the signing secret on your server. Anyone with it can spend your credits.

Errors

Errors come back as {"error": {"code": "...", "message": "..."}}. A failed render is never charged.

401 bad_keyMissing or wrong key.
402 no_creditsOut of credits for this month.
429 trial_limitNo key, and today's 3 free renders from this address are used up. Get a free key.
400 unknown_layerA slot name that isn't in this template. The message lists the real ones.
400 bad_imageAn image URL that isn't an https PNG, JPG or GIF.
404 no_templateNo template with that id.

Limits

  • Free images carry a small "Made with Platemark" mark in the corner.
  • Five new accounts per network per day.
  • Without a key you get 3 watermarked renders a day per IP address, not counting failed ones. Video isn't part of that.
  • We don't store the images you send or the PNGs we make. Photo links sit in a cache for up to an hour, and signed URLs stay cached so crawlers don't cost you credits.

Templates

Announcement, story: announcement-story

1080x1920. Sample

SlotTypeSample
photoimage URLa photo
kickertextStarting Monday
headlinetextWe're open until 9 on weeknights
footertext1120 Thames St

Just listed (real estate): just-listed-square

1080x1080. Sample

SlotTypeSample
photoimage URLa photo
statustext (pill)Just listed
pricetext$489,000
addresstext2214 Fleet Street, Baltimore
detailstext3 beds · 2 baths · 1,640 sq ft

Just listed, story: just-listed-story

1080x1920. Sample

SlotTypeSample
photoimage URLa photo
statustext (pill)Just listed
pricetext$489,000
addresstext2214 Fleet Street, Baltimore
detailstext3 beds · 2 baths · 1,640 sq ft
agenttextDana Reyes, Harbor Homes

Link preview (OG image): og-image

1200x630. Sample

SlotTypeSample
sitetextledgerline.com/blog
titletextHow we closed the books in two days instead of nine
subtitletextThree changes to month end that anyone can copy.

Link preview with photo: og-image-photo

1200x630. Sample

SlotTypeSample
photoimage URLa photo
sitetextledgerline.com
titletextThe month end checklist we actually use
subtitletextWith the template, free.

Product card: product-card-square

1080x1080. Sample

SlotTypeSample
photoimage URLa photo
badgetext (pill)New
nametextStoneware pour-over set
detailtextDripper, mug and 40 filters
pricetext$48

Quote card: quote-card-square

1080x1080. Sample

SlotTypeSample
accenttext
quotetextShip the boring version first. Then make it better every week.
authortextJane Okafor
roletextFounder, Ledgerline

Quote card, story: quote-card-story

1080x1920. Sample

SlotTypeSample
quotetextShip the boring version first. Then make it better every week.
authortextJane Okafor
roletextFounder, Ledgerline

Sale announcement: sale-banner-square

1080x1080. Sample

SlotTypeSample
kickertextThis weekend only
offertext30% off everything
detailtextEnds Sunday at midnight. Free shipping over $50.
codetext (pill)Code WEEKEND30

Social post over a photo: social-post-square

1080x1080. Sample

SlotTypeSample
photoimage URLa photo
kickertextOpen Saturdays
headlinetextPastries out of the oven at 7, gone by 10

Social post, portrait: social-post-portrait

1080x1350. Sample

SlotTypeSample
photoimage URLa photo
kickertextThis week
headlinetextPastries out of the oven at 7, gone by 10
footertext@corner.bakehouse

Video thumbnail: video-thumbnail

1280x720. Sample

SlotTypeSample
photoimage URLa photo
headlinetextI closed the books in 2 days
tagtext (pill)Month end