Search / io.betterimage/betterimage
protogridR0· no sign-inSocial cards and OG images from designed templates: card from a URL, presets, meta tags, link checks
v1.2.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"betterimage": {
"type": "http",
"url": "https://betterimage.io/mcp"
}
}
}claude mcp add --transport http betterimage https://betterimage.io/mcp[mcp_servers.betterimage]
url = "https://betterimage.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"betterimage": {
"type": "remote",
"url": "https://betterimage.io/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"betterimage": {
"type": "http",
"url": "https://betterimage.io/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=betterimage&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYmV0dGVyaW1hZ2UuaW8vbWNwIn0%3D"
}{
"servers": {
"betterimage": {
"type": "http",
"url": "https://betterimage.io/mcp"
}
}
}{
"mcpServers": {
"betterimage": {
"httpUrl": "https://betterimage.io/mcp"
}
}
}extensions:
"betterimage":
enabled: true
name: "betterimage"
type: streamable_http
uri: "https://betterimage.io/mcp"
timeout: 300
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltool list is cacheable (ttlMs 3600000)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations10 of 10 tools declare readOnlyHint or destructiveHinttools.directory_hints2 of 10 tools declare all four hints; missing: check_link_preview (destructiveHint); generate_meta_tags (destructiveHint); list_templates (destructiveHint); …tools.token_costabout 6,139 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes11 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageog_image_urlchangedinput schemarender_cardchangedinput schemasave_templatechangedinput schemapreview_cardchangedinput schemacard_from_urlchangedinput schemaog_image_urlchangedinput schemarender_cardchangedinput schemasave_templatechangedinput schemapreview_cardchangedinput schemalist_presetschangedinput schemaShowing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +dns-namespace +website +reachable +uptime-94% +updated-25d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://betterimage.io/mcp streamable-http | none | yes | 94% | 590 ms | 2026-07-28 | 2026-10-20 |
card_from_urlread-only | Make a social card for a page that already exists, in one call: fetches the page like a crawler, takes its title, description, author, domain and site icon, picks the starter design that fits the page (a Jev decision over every preset, about 100 ms) and returns the image (shown inline, watermarked, free). Use this first when the user gives a URL: "make an OG image for my latest post". Any field you pass overrides what the page says. Pass preset (see list_presets) to choose the design yourself, or a size. No API key needed; one page fetch plus one render per call. |
check_link_previewread-only | Fetch a public page the way X, Facebook, LinkedIn, Slack and Discord crawlers do and report what they will show: the effective title, description and image per platform, the og:image's real format, dimensions and weight, and a list of concrete problems with fixes. Use when a user asks why their link looks wrong when shared, or before publishing. Only http(s) URLs on the public internet; one page fetch plus up to two image fetches per call. No API key needed. |
generate_meta_tagsread-only | Build the complete <head> block for a page: <title>, meta description, canonical, Open Graph and Twitter card tags, with og:image width/height. Returns HTML to paste plus notes on anything worth fixing (title too long, image over http). Use after check_link_preview, or whenever a user needs the tags for a new page. No API key needed; nothing is fetched. |
get_usageread-only | The API key's plan, whether renders are watermarked, and this month's image quota: used, remaining, and the reset date. Needs an API key. Check it before batch renders, or when a render came back watermarked unexpectedly. |
list_presetsread-only | Browse the ready-made designs (presets) a card can start from: key, name, template kind, native size, use-case categories, a one-line look description and a preview image URL. Start here when the user wants a social card and has no saved template. Then call preview_card with the chosen key. No API key needed. |
list_templatesread-only | The user's saved templates (their own designs, made in the editor or with save_template): slug, name, kind, the fields render_card and og_image_url can override, and when it was last edited. Needs an API key. Call this before render_card or og_image_url when you do not know the slug. |
og_image_urlread-only | Build a signed image URL for a saved template with the given text, ready to put in a page's <meta property="og:image"> tag. Nothing is rendered now: the image is generated when a crawler fetches the URL, cached at the edge for a day, and each uncached fetch spends one image of the monthly quota. Needs an API key. This is the zero-infrastructure way to give every page its own card; use it in page templates, CMS hooks and static site generators. Returns the URL and the ready meta tag. |
preview_cardread-only | Render a preset with the user's text and return the image (shown inline). Free, no API key; the preview carries a small betterimage.io watermark and does not touch any quota. Use it to show the user what their card will look like before they commit. For a clean image: save_template + render_card on a paid API plan, or the one-off clean download in the editor. |
render_card | Render one of the user's saved templates with the given text and return the PNG (shown inline, at 1x). Needs an API key. On a paid plan the image is clean (no watermark); on the free tier it is watermarked. Each call spends one image of the monthly quota. Use it when the user wants the actual file, e.g. to host it themselves. For an og:image tag that needs no hosting, or for a 2x retina file, prefer og_image_url. |
save_template | Copy a preset (optionally with the user's text as its new defaults) into the user's account as a saved template, so render_card and og_image_url can use it. Needs an API key. Do this once per design, not per image: afterwards every render only passes the text that changes. Returns the slug to use next and a link to fine-tune the design in the editor. |
Schemas: list_tools.
{
"name": "io.betterimage/betterimage",
"icons": [
{
"src": "https://betterimage.io/icon-192.png",
"sizes": [
"192x192"
],
"mimeType": "image/png"
}
],
"title": "betterimage.io",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://betterimage.io/mcp",
"type": "streamable-http"
}
],
"version": "1.2.0",
"repository": {
"url": "https://github.com/mfundakowski/betterimage-mcp",
"source": "github"
},
"websiteUrl": "https://betterimage.io/mcp",
"description": "Social cards and OG images from designed templates: card from a URL, presets, meta tags, link checks"
}