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
{
"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