Shareglow
Allows forcing Facebook to re-fetch a page's link preview after Open Graph tags or images change, via the refresh_preview tool, which re-scrapes Facebook as part of Shareglow's preview refresh.
shareglow-mcp
MCP server for Shareglow: scan link previews, generate Open Graph images, create short links with their own preview, and read click stats from any MCP client.
It is a thin client of the Shareglow REST API (/v1). Your API key is passed straight through, so plan limits and rate limits apply unchanged. The server holds no credentials of its own.
Hosted endpoint
https://mcp.getshareglow.com/mcp
Authorization: Bearer sk_live_...Transport: Streamable HTTP. Create an API key at https://app.getshareglow.com/developer.
Related MCP server: picoli-mcp
Tools
Tool | Description |
| Scan a public web page and report its link-preview (Open Graph / Twitter Card) metadata, previews per platform, and issues with fix suggestions. |
| Render a 1200x630 Open Graph image from a template id (see |
| Use AI to design a new OG image template from a website's brand (logo, colors, fonts) taken from a URL. Returns the layout id, the variables to pass, and the extracted brand kit. Counts against the plan's AI quota. |
| List the OG image templates the workspace can render (built-in and custom) with id, name, version and dimensions. |
| Create a short link with its own link preview. Optional custom slug and optional A/B variants (title, description, imageUrl or templateId). Returns id, shortUrl and variants. |
| Get click analytics for a short link by id: totals plus breakdowns by day, country, device, browser and referrer. Optional |
| Force social platforms to re-fetch a page's link preview after you changed its OG tags or image: bumps the og:image cache-buster, re-scrapes Facebook, and returns the LinkedIn Post Inspector link and the X cache note. |
Client setup
Claude Code
claude mcp add --transport http shareglow https://mcp.getshareglow.com/mcp \
--header "Authorization: Bearer sk_live_..."Claude Desktop
Claude Desktop reaches remote servers through mcp-remote. Add to claude_desktop_config.json:
{
"mcpServers": {
"shareglow": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.getshareglow.com/mcp", "--header", "Authorization:${AUTH}"],
"env": { "AUTH": "Bearer sk_live_..." }
}
}
}Or skip the remote and use the stdio server below.
Cursor
~/.cursor/mcp.json:
{
"mcpServers": {
"shareglow": {
"url": "https://mcp.getshareglow.com/mcp",
"headers": { "Authorization": "Bearer sk_live_..." }
}
}
}Local stdio (any client)
{
"mcpServers": {
"shareglow": {
"command": "npx",
"args": ["-y", "shareglow-mcp"],
"env": { "SHAREGLOW_API_KEY": "sk_live_..." }
}
}
}The key can also be passed as --api-key sk_live_.... SHAREGLOW_API_URL points the server at another REST base (default https://app.getshareglow.com).
Errors and limits
Each tool needs the key scope of its REST call. A key without it gets
403 insufficient_scope.REST
401,402,403and429become MCP tool errors (isError: true) that carry the API's message.URLs are validated before forwarding (http/https, no private or local hosts).
Tool results are truncated at 20,000 characters. The API key is redacted from every result and error.
Local development
npm install
npm run typecheck
npm test
npm run build
npm run dev # Streamable HTTP on PORT (default 8791)
npm run dev:worker # Cloudflare Worker via wrangler devNode 22 or newer is required.
License
MIT, see LICENSE.
Available Tools
7 toolscreate_short_linkAInspect
Create a short link with its own link preview. Optional custom slug, and optional A/B variants (each with a title, description, imageUrl or templateId) to test which preview gets more clicks. Returns id, shortUrl and variants. Use the id with get_link_stats.
Inputs: destination (required), slug, variants.
create_template_from_urlAInspect
Use AI to design a new OG image template from a website's brand (logo, colors, fonts) taken from a URL. Returns the chosen layoutId (a built-in template id usable with generate_og_image), the variables to pass, and the extracted brand kit. Counts against the plan's AI quota.
Inputs: url (required).
generate_og_imageAInspect
Render a 1200x630 Open Graph image from a template id (see list_templates) and text params such as title and subtitle. Returns the permanent image URL to put in og:image, and whether it was already cached. Optional exp (Unix seconds, paid plans) makes the signed URL expire; leave it out for an og:image URL.
Inputs: templateId (required), exp, params.
get_link_statsARead-onlyInspect
Get click analytics for a short link by id (from create_short_link): totals plus breakdowns by day, country, device, browser and referrer. Optional from/to dates (YYYY-MM-DD).
Inputs: linkId (required), to, from.
list_templatesARead-onlyInspect
List the OG image templates the workspace can render (built-in and custom) with id, name, version and dimensions. Call this before generate_og_image to pick a templateId.
Inputs: no named parameters.
refresh_previewAInspect
Force social platforms to re-fetch a page's link preview after you changed its OG tags or image: bumps the og:image cache-buster, re-scrapes Facebook, and returns the LinkedIn Post Inspector link and the X cache note.
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: scanning a page, rendering an image, listing templates, creating a template, creating a short link, reading stats, and refreshing previews. The main potential overlap is between scan_url and refresh_preview, since both concern link previews, but the descriptions distinguish diagnosis from cache invalidation.
All tool names use snake_case and follow a verb-first pattern such as scan_url, list_templates, create_short_link, and get_link_stats. The few longer names like generate_og_image and create_template_from_url remain readable and consistent with the convention.
Seven tools is well-scoped for a link-preview and OG-image service. Each tool covers a distinct step in the workflow, and there is no obvious redundancy or padding.
The core workflow is covered: scan previews, list/create templates, generate images, create short links, view stats, and refresh previews. However, lifecycle operations are thin for short links and templates, with no list/update/delete tools for either resource, which limits management beyond initial creation.
Related MCP Connectors
Check link previews (Open Graph, Twitter cards) on X, LinkedIn, Slack; OG images per page.
Social cards and OG images from designed templates: card from a URL, presets, meta tags, link checks
Check a link's share card on X, Facebook, LinkedIn: real image size, tag problems, fixed tags.
Pay-per-call Open Graph/link preview metadata for AI agents. $0.01 USDC per call, no signup.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenancePaste a URL to see exactly how it renders as a social card on Twitter, LinkedIn, Facebook, and Slack. Generate custom OG images from templates.MIT
- AlicenseAqualityDmaintenanceEnables URL shortening, click tracking, and analytics for AI agents via the picoli.site API.592 npm2MIT
- AlicenseNot gradedqualityDmaintenanceZero-signup link-preview API that returns clean metadata (title, description, image, etc.) from any public URL. No API key required.2MIT
- AlicenseAqualityDmaintenanceEnables AI agents to shorten URLs, manage links, and track click analytics through 8 first-class tools, designed for use with Claude Desktop, Cursor, and other MCP clients.946 npmMIT