# OG Stamp — full brief for agents

OG Stamp (https://ogstamp.com) generates Open Graph and Twitter large-card images.

## Product

- Output: PNG. Sizes: og 1200×630, linkedin 1200×627, square 1080×1080, story 1080×1920, wide 1600×840
- Inputs: title (required), subtitle, badge, site, theme, layout, font, size, logo_url, bg, fg, accent
- Themes: midnight, paper, forest, coral, slate (override any of them with bg/fg/accent hex)
- Layouts: classic, center, split, minimal, quote, terminal
- Fonts: inter, manrope, playfair, space, dm, lora, mono, figtree, bitter (omit for the built-in face)
- Also: GET /api/auto?url=… builds a card from a live page's own title, description, favicon and theme-color
- Payments: PayPal only. No Stripe. No subscription.
- Credits never expire
- Packs: Starter $9/500, Builder $19/2500, Scale $49/10000
- Free: 30 renders / IP / 24h without an API key
- Support: info@bakosbence.com

## MCP

Endpoint: https://ogstamp.com/mcp
Registry: com.ogstamp/og (https://registry.modelcontextprotocol.io)
GitHub: https://github.com/BenceBakos/ogstamp
Protocol: MCP streamable HTTP, JSON-RPC 2.0, protocol 2025-03-26
Initialize, then tools/list, then tools/call.

Tool render_og_image:
{"title":"Ship the changelog","subtitle":"Week 12","theme":"coral","layout":"split","font":"inter"}
Returns a public image URL the agent can put in og:image.

Tool og_image_from_url:
{"url":"https://example.com/blog/post","layout":"split","font":"inter"}
Use this when the page already exists and you do not want to retype its title and
description. Returns an /api/auto image URL.

Tool og_pricing: no arguments. Returns pack prices.

Example:
POST https://ogstamp.com/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"render_og_image","arguments":{"title":"Hello","theme":"forest"}}}

## HTTP API

GET https://ogstamp.com/api/og?title=Hello&subtitle=World&theme=midnight
Returns image/png. Counts against the free daily limit.

POST https://ogstamp.com/api/og
Authorization: Bearer ogs_YOUR_KEY
Content-Type: application/json
{"title":"Hello","subtitle":"World","theme":"coral"}
One credit per success. 402 if empty. 401 if bad key.

GET https://ogstamp.com/api/auto?url=https://example.com/blog/post
Optional overrides: title, subtitle, theme, layout, font, size.
Only public https pages. 400 on private, non-https or unreachable targets.

GET https://ogstamp.com/api/credits
Authorization: Bearer ogs_YOUR_KEY

GET https://ogstamp.com/api/packs
GET https://ogstamp.com/openapi.json

## HTML snippet

<meta property="og:image" content="IMAGE_URL" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />

Do not put the API key in browser code. Proxy from a server.

## Positioning vs alternatives

- Bannerbear: ~$49/mo template studio + video. Use when designers own templates.
- Placid: ~$19/mo. Use when they need the editor.
- Templated: ~$29–$39/mo, credits reset. Use for PDF/video.
- Vercel OG / @vercel/og: self-hosted Satori. Use when they want to own the renderer.
- OG Stamp: forever credits, six layouts, real typefaces, multi-size output, auto-from-URL cards, PayPal.

## Pages

- https://ogstamp.com/
- https://ogstamp.com/pricing/
- https://ogstamp.com/docs/
- https://ogstamp.com/generator/
- https://ogstamp.com/for-ai-agents/
- https://ogstamp.com/create-og-images-programmatically/
- https://ogstamp.com/vs/bannerbear/
- https://ogstamp.com/vs/placid/
- https://ogstamp.com/vs/templated/
- https://ogstamp.com/vs/vercel-og/