ogmake MCP
Generate og:image social cards and signed ogmake.com image URLs from your AI assistant.
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: creates or changes data: records, files, settings.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y ogmake-mcp
MCP client config
{
"mcpServers": {
"ogmake-mcp": {
"command": "npx",
"args": [
"-y",
"ogmake-mcp"
]
}
}
}Local stdio MCP server for
ogmake.com og:image generation. Run it with
npx -y ogmake-mcp.
Tools
list_templates— lists every registered og:image template id, version, and its params JSON Schema. No API key required.render_html— renders raw HTML/CSS to a stored PNG/JPG/WebP/PDF (2 credits; needsOGMAKE_API_KEY).render_image— renders an og:image.- With
OGMAKE_API_KEYset: renderstemplate(+ optionalparams,format,preset,scale,v,bg,font— a Google Fonts family) via the authenticated API and returns its hosted URL plus the image bytes. - With no
OGMAKE_API_KEY: renders a watermarked free image fromtitle(+ optionaldescription,site) and returns image bytes only — no hosted URL (the free endpoint never stores one).
- With
create_batch— starts an async batch of up to 500 renders (POST /v1/batch); returns abatch_idimmediately. OptionalwebhookUrl(https) gets a signedbatch.completedevent. NeedsOGMAKE_API_KEY.get_batch— a batch's status plus each item's stored URL or error. NeedsOGMAKE_API_KEY.build_image_url— builds an image URL fortemplatewithout rendering it.- With
OGMAKE_SIGNING_SECRET+OGMAKE_SIGNING_KEY_IDset: signs the URL locally (HMAC-SHA256) — the signing secret never leaves your machine and is never sent to the model. - Else with
OGMAKE_PUBLIC_KEY_IDset: builds an unsigned/p/:keyId/:templateURL (the key must be marked public and allow-list that template on ogmake.com).
- With
og_snippet— renders theog:image/twitter:imagemeta tag snippet for a given framework (html,hugo,jekyll,rails,laravel,django,wordpress,ghost) and image URL.get_usage— current billing period's render usage/quota for theOGMAKE_API_KEYaccount. RequiresOGMAKE_API_KEY.
Every secret (OGMAKE_API_KEY, OGMAKE_SIGNING_SECRET) stays local: it is
read from the environment once at startup and is never echoed back in a
tool result, error message, or log line.
Environment variables
| Variable | Required for |
|---|---|
OGMAKE_API_KEY | authenticated render_image, render_html, create_batch, get_batch, get_usage |
OGMAKE_BASE_URL | optional — override the API origin (defaults to https://ogmake.com) |
OGMAKE_SIGNING_SECRET | local signing in build_image_url (base64url) |
OGMAKE_SIGNING_KEY_ID | local signing in build_image_url (paired with the secret above) |
OGMAKE_PUBLIC_KEY_ID | unsigned /p URLs in build_image_url |
Install
Claude Code
claude mcp add ogmake --env OGMAKE_API_KEY=og_live_... -- npx -y ogmake-mcp
Or add to .mcp.json (project scope) / ~/.claude.json (user scope); Cursor
takes the same block in ~/.cursor/mcp.json:
{
"mcpServers": {
"ogmake": {
"command": "npx",
"args": ["-y", "ogmake-mcp"],
"env": { "OGMAKE_API_KEY": "og_live_..." }
}
}
}
Without OGMAKE_API_KEY only list_templates, watermarked free render_image,
build_image_url and og_snippet work.
Support: support@ogmake.com · License: MIT
Development
pnpm --filter ogmake-mcp run test # unit tests, 100% coverage
pnpm --filter ogmake-mcp run test:e2e # spawns the packed CLI over stdio against a local wrangler dev
pnpm --filter ogmake-mcp run build # tsup bundle -> dist/index.js
pnpm --filter ogmake-mcp run pack # build + npm pack -> pack-out/*.tgz
Development
vendor/ holds the SDK and request-signing helper this server bundles, so the
repository builds standalone: npm install && npm run build && npm test.
