MCPサーバー

ShareCut QR & Short Links

io.github.LucaRSdeCo/sharecut-mcp

このMCPでできること

Creates static or editable QR codes and short links, supports bulk URL shortening and destination updates, and provides click analytics by geography, device, browser, and referrer.

check_short_code
Check a custom short code
FREE, no API key needed. Check whether a custom short code is still free before trying to claim it with shorten_url. Codes are lowercase letters, digits and hyphens, up to 10 characters.
入力スキーマ
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'The custom code to test, e.g. "spring26".'}}}
create_qr
Create a QR code
FREE, no API key needed. Render any URL or text as a QR code and return it as SVG, optionally also as a PNG data URL. This QR is STATIC: its destination is baked in and cannot be changed once printed. If the destination might ever change, use shorten_url instead — that QR points at a ShareCut short link, stays editable after printing (see update_link) and counts every scan.
入力スキーマ
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'string', 'description': 'URL or text to encode, up to 2000 characters.'}, 'color': {'type': 'string', 'description': 'Foreground colour as a hex value, e.g. #2563eb. Background is always white.'}, 'format': {'enum': ['png'], 'type': 'string', 'description': 'Also return a PNG data URL alongside the SVG.'}}}
delete_link
Delete a link
Permanently delete a link and its click history. Every QR code and shared copy pointing at it stops working immediately, and the short code is released. There is no undo. Prefer update_link when the goal is to send the link somewhere else. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'required': ['link', 'confirm'], 'properties': {'link': {'type': 'string', 'description': 'The link, given either as its short code (the part after sharecut.site/) or as the id returned when it was created. A full ShareCut URL is accepted too.'}, 'confirm': {'type': 'boolean', 'description': 'Must be true. Deletion is permanent and breaks every printed copy.'}}}
expand_short_link
Expand a short link
FREE, no API key needed. Look up where a sharecut.site short link actually goes, and how many times it has been used, without opening it. Useful before following or forwarding a link someone sent. Only resolves ShareCut links.
入力スキーマ
{'type': 'object', 'required': ['shortCode'], 'properties': {'shortCode': {'type': 'string', 'description': 'The short code, or a full https://sharecut.site/... URL.'}}}
get_account
Get account and quota
Read the plan behind the API key, what it entitles, how much of this month’s API quota is left and when it resets, plus how many links the account holds and their total clicks. Worth calling before a bulk run. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'properties': {}}
get_link
Get a link
Read one link on the account: its destination, title, click count, creation date and UTM settings. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'required': ['link'], 'properties': {'link': {'type': 'string', 'description': 'The link, given either as its short code (the part after sharecut.site/) or as the id returned when it was created. A full ShareCut URL is accepted too.'}}}
get_link_analytics
Get link analytics
Read the click analytics of one link: total clicks, a daily series, and breakdowns by country, device, operating system, browser and referrer. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'required': ['link'], 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'How many days of the daily series to return. Default 30.'}, 'link': {'type': 'string', 'description': 'The link, given either as its short code (the part after sharecut.site/) or as the id returned when it was created. A full ShareCut URL is accepted too.'}}}
get_link_qr
Get the QR code of a link
Fetch the QR code for an existing link, ready to print. Returns the artwork saved on the link when there is one (frames, colours and logo set in the ShareCut editor), otherwise renders a plain code for its short URL. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'required': ['link'], 'properties': {'link': {'type': 'string', 'description': 'The link, given either as its short code (the part after sharecut.site/) or as the id returned when it was created. A full ShareCut URL is accepted too.'}, 'color': {'type': 'string', 'description': 'Foreground hex colour for a plain code, e.g. #2563eb.'}, 'style': {'enum': ['stored', 'plain'], 'type': 'string', 'description': 'Saved artwork if any (default), or force a plain black-and-white code.'}, 'format': {'enum': ['png'], 'type': 'string', 'description': 'Also return a PNG data URL. Applies when a plain code is rendered.'}}}
list_links
List links
List the links on the account the API key belongs to: short links, link-in-bio pages and restaurant menus, with their click counts. Filter by type or by a search term, and sort by newest or by most clicked. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Match against short code, title, description and destination.'}, 'sort': {'enum': ['created', 'clicks'], 'type': 'string', 'description': 'Newest first (default) or most clicked first.'}, 'type': {'enum': ['short', 'linktree', 'menu'], 'type': 'string', 'description': 'Only links of this kind.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'How many to return. Default 20.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'How many to skip, for paging. Default 0.'}}}
shorten_url
Shorten a URL
Create a ShareCut short link for a URL and get a matching QR code. Unlike a static QR, this one points at the short link, so update_link can change where it goes after it has been printed, and every scan is counted (country, device, referrer). Destinations are screened with Google Safe Browsing. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The http(s) destination to shorten.'}, 'utm': {'type': 'object', 'properties': {'term': {'type': 'string'}, 'medium': {'type': 'string'}, 'source': {'type': 'string'}, 'content': {'type': 'string'}, 'campaign': {'type': 'string'}}, 'description': 'Optional UTM parameters appended to the destination at redirect time: source, medium, campaign, term, content. The stored destination stays clean.'}, 'title': {'type': 'string', 'description': 'Optional label for the link, shown in the owner dashboard. Not visible to visitors.'}, 'customCode': {'type': 'string', 'description': 'Optional custom short code: lowercase letters, digits and hyphens, up to 10 characters. Fails if already taken — check_short_code tests one first.'}}}
shorten_urls_bulk
Shorten several URLs
Create up to 25 short links in one call. Each entry takes the same fields as shorten_url. Failures are reported per item, so one bad URL does not discard the rest. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'required': ['links'], 'properties': {'links': {'type': 'array', 'items': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The http(s) destination to shorten.'}, 'title': {'type': 'string', 'description': 'Optional label.'}, 'customCode': {'type': 'string', 'description': 'Optional custom short code.'}}}, 'maxItems': 25, 'description': 'The links to create.'}}}
update_link
Change where a link points
Re-point an existing short link at a new destination, or change its title, description or UTM parameters. This is what makes a printed QR code reusable: the code encodes the short link, so changing the destination redirects every copy already printed, shared or stuck on a wall, and the click history is kept. The new destination is screened with Google Safe Browsing. The short code itself never changes here, because changing it would break every copy already out there. Requires a ShareCut API key (Business plan).
入力スキーマ
{'type': 'object', 'required': ['link'], 'properties': {'url': {'type': 'string', 'description': 'The new http(s) destination. Short links only — a menu or link-in-bio page has no single destination.'}, 'utm': {'type': 'object', 'properties': {'term': {'type': 'string'}, 'medium': {'type': 'string'}, 'source': {'type': 'string'}, 'content': {'type': 'string'}, 'campaign': {'type': 'string'}}, 'description': 'UTM parameters appended at redirect time. Pass an empty object to switch UTM tracking off.'}, 'link': {'type': 'string', 'description': 'The link, given either as its short code (the part after sharecut.site/) or as the id returned when it was created. A full ShareCut URL is accepted too.'}, 'title': {'type': 'string', 'description': 'New label for the owner dashboard.'}, 'description': {'type': 'string', 'description': 'New description.'}}}
追加
get_account
2026年9月17日12:43
追加
delete_link
2026年9月17日12:43
追加
get_link_qr
2026年9月17日12:43
追加
get_link_analytics
2026年9月17日12:43
追加
update_link
2026年9月17日12:43
追加
get_link
2026年9月17日12:43
追加
list_links
2026年9月17日12:43
追加
shorten_urls_bulk
2026年9月17日12:43
追加
shorten_url
2026年9月17日12:43
追加
check_short_code
2026年9月17日12:43
追加
expand_short_link
2026年9月17日12:43
追加
create_qr
2026年9月17日12:43