sharecut-mcp

sharecut-mcp

MCP server for ShareCut — generate QR codes, create trackable short links, re-point them after the QR is printed, and read their click analytics from Claude, Cursor, or any MCP client.

QR codes, link expansion and short-code checks are free and need no account.

Install

Remote server, nothing to install:

claude mcp add --transport http sharecut https://sharecut.site/mcp

Or run this package over stdio:

npx sharecut-mcp

Config file (Claude Desktop, Cursor, …)

{
  "mcpServers": {
    "sharecut": {
      "command": "npx",
      "args": ["-y", "sharecut-mcp"],
      "env": { "SHARECUT_API_KEY": "sc_live_..." }
    }
  }
}

SHARECUT_API_KEY is optional — leave it out and the three free tools still work.

Free tools — no API key, no account

Tool	What it does
create_qr	Renders any URL or text as a QR code: SVG, plus a PNG data URL with format: "png", and an optional hex color. The code is static — the destination is baked into the pattern, so once printed it points there forever.
expand_short_link	Resolves a sharecut.site short link to its real destination and click count, without opening it.
check_short_code	Tells you whether a custom short code is still free before you try to claim it.

Tools that need an API key

The interesting half. All of them act on the account the key belongs to.

update_link — the reason this server exists

Changes where an existing short link points. A ShareCut QR encodes the short link, not the destination, so re-pointing the link redirects every copy already printed, shared or stuck on a wall — and the click history comes along.

That difference is the whole point. A poster, a menu, a business card or a product label outlives the URL printed on it. A static QR does not survive a site migration or a campaign change; this one does.

The short code itself is deliberately immutable here: changing it would break every copy already in circulation.

The rest

Tool	What it does
shorten_url	Creates a short link plus its QR code. Optional customCode, title and utm. Destinations are screened against Google Safe Browsing.
shorten_urls_bulk	Up to 25 links in one call, with per-item results so one bad URL does not discard the rest.
list_links	Lists your links with click counts — filter by kind or search term, sort by newest or most clicked.
get_link	Destination, title, clicks, creation date and UTM settings for one link.
get_link_analytics	Clicks over time, plus breakdowns by country, device, OS, browser and referrer.
get_link_qr	The QR code of an existing link, using the artwork saved on it (frames, colours, logo) when there is one.
delete_link	Permanent, and it releases the short code. Needs an explicit confirm.
get_account	Plan, entitlements and how much API quota is left this month. Worth calling before a bulk run.

API key

Create it at sharecut.site/p/profile — API access is part of the Business plan — then pass it as SHARECUT_API_KEY.

There is no programmatic sign-up: a person creates the key. See auth.md for the full authentication contract.

How it works

This package is a thin stdio bridge to https://sharecut.site/mcp. It moves newline-delimited JSON-RPC to that endpoint and back, which means zero dependencies (fast npx start) and no upgrades to chase: the tools live on the server, so new ones reach you without touching your config.

Point SHARECUT_MCP_URL elsewhere to target a different deployment.

Links

• Documentation — https://sharecut.site/p/api/
• OpenAPI — https://sharecut.site/openapi.json
• Server card — https://sharecut.site/.well-known/mcp/server-card.json

MIT