betterimage.io MCP server
MCP serverEverything elseSocial 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.
No other account needed.
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/mcpAdd 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=eyJ1cmwiOiJodHRwczovL2JldHRlcmltYWdlLmlvL21jcCJ9Open the link and Cursor adds the server at that address.
ChatGPT
https://betterimage.io/mcpIn 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
| URL | Auth | Use |
|---|---|---|
https://betterimage.io/mcp | none (optional API key) | Free tools work with no account. Pass Authorization: Bearer <api key> to unlock the account tools. |
https://betterimage.io/mcp/account | OAuth 2.1 | Same 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.jsonin 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
- Documentation: https://betterimage.io/mcp
- Privacy: https://betterimage.io/privacy
- Terms: https://betterimage.io/terms
- Support: hello@betterimage.io
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