Ogmake MCP

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; needs OGMAKE_API_KEY).
• `render_image` — renders an og:image.
• With OGMAKE_API_KEY set: renders template (+ optional params, 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 from title (+ optional description, site) and returns image bytes only — no hosted URL (the free endpoint never stores one).
• `create_batch` — starts an async batch of up to 500 renders (POST /v1/batch); returns a batch_id immediately. Optional webhookUrl (https) gets a signed batch.completed event. Needs OGMAKE_API_KEY.
• `get_batch` — a batch's status plus each item's stored URL or error. Needs OGMAKE_API_KEY.
• `build_image_url` — builds an image URL for template without rendering it.
• With OGMAKE_SIGNING_SECRET + OGMAKE_SIGNING_KEY_ID set: 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_ID set: builds an unsigned /p/:keyId/:template URL (the key must be marked public and allow-list that template on ogmake.com).
• `og_snippet` — renders the og:image/twitter:image meta 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 the OGMAKE_API_KEY account. Requires OGMAKE_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

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.