betterimage.io MCP server

MCP serverEverything else

Social cards and OG images from designed templates: card from a URL, presets, meta tags, link checks

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use betterimage.io MCP server

Install betterimage.io MCP server

The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http betterimage-io-mcp-server 'https://betterimage.io/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://betterimage.io/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=betterimage-io-mcp-server&config=eyJ1cmwiOiJodHRwczovL2JldHRlcmltYWdlLmlvL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://betterimage.io/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add betterimage-io-mcp-server --url 'https://betterimage.io/mcp'

    Run it once, then sign in with codex mcp login betterimage-io-mcp-server if the server asks for an account.

From the project's README

As published by mfundakowski/betterimage-mcp in README.md.

Social cards and OG images for your AI assistant. Give Claude, Cursor, VS Code or any MCP client a page URL and get back a link-preview card on a design picked to fit the page; browse 100 starter designs, preview them with your own text, check how a link previews on X, LinkedIn, Slack and Discord, generate Open Graph and Twitter tags, and with an account save templates, render clean images and get signed og:image URLs that need no hosting.

Every image is rendered from a designed template by a deterministic renderer: the text changes, layout, fonts and colours stay on-brand. No generative image model is involved.

This repository holds the public distribution files for the hosted server (install manifests, registry metadata). The server itself runs at https://betterimage.io/mcp and is documented at https://betterimage.io/mcp.

Endpoints

URLAuthUse
https://betterimage.io/mcpnone (optional API key)Free tools work with no account. Pass Authorization: Bearer <api key> to unlock the account tools.
https://betterimage.io/mcp/accountOAuth 2.1Same server; an unauthenticated call answers 401 and starts the sign-in flow in claude.ai, Claude Desktop, Claude Code and other OAuth-capable clients.

Transport: Streamable HTTP. Protocol revisions 2024-11-05 through 2026-07-28.

Install

Claude Code

# free tools, no account
claude mcp add --transport http betterimage https://betterimage.io/mcp

# your own templates: sign in once (run /mcp in a session, pick betterimage, Authenticate)
claude mcp add --scope user --transport http betterimage https://betterimage.io/mcp/account

claude.ai / Claude Desktop: Settings > Connectors > Add custom connector, URL https://betterimage.io/mcp/account.

Cursor: one-click install button on https://betterimage.io/mcp, or add to mcp.json:

{
  "mcpServers": {
    "betterimage": { "url": "https://betterimage.io/mcp" }
  }
}

VS Code: one-click install button on https://betterimage.io/mcp, or add to .vscode/mcp.json:

{
  "servers": {
    "betterimage": { "type": "http", "url": "https://betterimage.io/mcp" }
  }
}

Gemini CLI: gemini extensions install https://github.com/mfundakowski/betterimage-mcp, or add to settings.json:

{
  "mcpServers": {
    "betterimage": { "httpUrl": "https://betterimage.io/mcp" }
  }
}

ChatGPT (Plus/Pro, Developer mode): Settings > Apps & Connectors > Create, URL https://betterimage.io/mcp, no authentication.

Any other client: point it at https://betterimage.io/mcp over Streamable HTTP.

Tools

No account needed:

  • card_from_url: a social card for an existing page, in one call. Fetches the page like a crawler, picks the design that fits it, returns the image (watermarked preview).
  • list_presets: the 100 starter designs with key, size, categories and preview image.
  • preview_card: render a preset with your text (watermarked preview, no quota).
  • check_link_preview: what X, Facebook, LinkedIn, Slack and Discord will show for a URL, with concrete fixes.
  • generate_meta_tags: the complete <head> block with Open Graph and Twitter tags.

With an account (OAuth or API key):

  • list_templates, save_template: your saved designs.
  • render_card: a clean PNG from a saved template (paid plans; watermarked on the free tier).
  • og_image_url: a signed og:image URL rendered on first fetch and cached at the edge, so every page gets its own card with no hosting.
  • get_usage: plan, watermark status and monthly quota.

Every tool carries a title and readOnlyHint/destructiveHint annotations; the two write tools are save_template and render_card.

Registries

  • Official MCP Registry: io.betterimage/betterimage (server.json in this repo)
  • Smithery: @matfun93/betterimage

Cursor plugin

.cursor-plugin/plugin.json and mcp.json make this repository installable as a Cursor plugin; the plugin only registers the hosted server.

Links

Advanced
Delivery
betterimage MCP server → your ahel gateway (mcp.ahel.ai) → every connected AI client.
Catalog kind
mcp-server
Gateway key
io-betterimage-betterimage
Source
github.com/mfundakowski/betterimage-mcp
Hosted endpoint
https://betterimage.io/mcp