Platemark
Make invoice, quote and receipt PDFs with the math done to the cent, plus certificates, letters, social images and short videos. Remote server with an agent signup tool.
Hosted MCP Server
npx add-mcp 'https://platemark.rowhousesoftware.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
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
template | A template id, like og-image. |
|---|---|
modifications | An object keyed by slot name. Leave out a slot to keep its sample. |
response | Optional. "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_leftorpan_right. Transitions arefadeorcut. - 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.
invoice | from, 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) |
|---|---|
quote | The invoice fields, plus valid_until or valid_days (default 30). No amount due. |
receipt | The invoice fields, plus paid_date and payment_method. Marked Paid. |
certificate | title, recipient, reason, kicker, presented, signatures [{name, role}] (up to 2), date, id, accent |
letter | from, 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, values | One label per value. For several series, send series: [{name, values}] instead (up to 8). null leaves a gap in a line. |
|---|---|
format | number, currency (with currency, like EUR) or percent (12.5 means 12.5%). Add locale and decimals if you need them. |
highlight | A label to emphasize. Its bar or slice keeps its color and the rest go gray. |
size | landscape 1200x675 (default), og 1200x630, square, portrait, story, or width and height from 300 to 2400. |
theme, colors | light or dark. colors overrides the series colors in order, as hex. |
source, show_values, y_min, y_max | A 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_key | Missing or wrong key. |
|---|---|
402 no_credits | Out of credits for this month. |
429 trial_limit | No key, and today's 3 free renders from this address are used up. Get a free key. |
400 unknown_layer | A slot name that isn't in this template. The message lists the real ones. |
400 bad_image | An image URL that isn't an https PNG, JPG or GIF. |
404 no_template | No 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
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
kicker | text | Starting Monday |
headline | text | We're open until 9 on weeknights |
footer | text | 1120 Thames St |
Just listed (real estate): just-listed-square
1080x1080. Sample
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
status | text (pill) | Just listed |
price | text | $489,000 |
address | text | 2214 Fleet Street, Baltimore |
details | text | 3 beds · 2 baths · 1,640 sq ft |
Just listed, story: just-listed-story
1080x1920. Sample
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
status | text (pill) | Just listed |
price | text | $489,000 |
address | text | 2214 Fleet Street, Baltimore |
details | text | 3 beds · 2 baths · 1,640 sq ft |
agent | text | Dana Reyes, Harbor Homes |
Link preview (OG image): og-image
1200x630. Sample
| Slot | Type | Sample |
|---|---|---|
site | text | ledgerline.com/blog |
title | text | How we closed the books in two days instead of nine |
subtitle | text | Three changes to month end that anyone can copy. |
Link preview with photo: og-image-photo
1200x630. Sample
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
site | text | ledgerline.com |
title | text | The month end checklist we actually use |
subtitle | text | With the template, free. |
Product card: product-card-square
1080x1080. Sample
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
badge | text (pill) | New |
name | text | Stoneware pour-over set |
detail | text | Dripper, mug and 40 filters |
price | text | $48 |
Quote card: quote-card-square
1080x1080. Sample
| Slot | Type | Sample |
|---|---|---|
accent | text | |
quote | text | Ship the boring version first. Then make it better every week. |
author | text | Jane Okafor |
role | text | Founder, Ledgerline |
Quote card, story: quote-card-story
1080x1920. Sample
| Slot | Type | Sample |
|---|---|---|
quote | text | Ship the boring version first. Then make it better every week. |
author | text | Jane Okafor |
role | text | Founder, Ledgerline |
Sale announcement: sale-banner-square
1080x1080. Sample
| Slot | Type | Sample |
|---|---|---|
kicker | text | This weekend only |
offer | text | 30% off everything |
detail | text | Ends Sunday at midnight. Free shipping over $50. |
code | text (pill) | Code WEEKEND30 |
Social post over a photo: social-post-square
1080x1080. Sample
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
kicker | text | Open Saturdays |
headline | text | Pastries out of the oven at 7, gone by 10 |
Social post, portrait: social-post-portrait
1080x1350. Sample
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
kicker | text | This week |
headline | text | Pastries out of the oven at 7, gone by 10 |
footer | text | @corner.bakehouse |
Video thumbnail: video-thumbnail
1280x720. Sample
| Slot | Type | Sample |
|---|---|---|
photo | image URL | a photo |
headline | text | I closed the books in 2 days |
tag | text (pill) | Month end |