ShareCut QR & Short Links
Short links you can re-point after printing the QR, with click analytics. Free QR, no key.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http sharecut-qr-short-links 'https://sharecut.site/mcp' --header 'Authorization: <Optional. ShareCut API key as '\''Bearer sc_live_...'\'', required only by shorten_url (Business plan). create_qr works with no credentials at all.>'{
"mcpServers": {
"sharecut-qr-short-links": {
"type": "http",
"url": "https://sharecut.site/mcp",
"headers": {
"Authorization": "<Optional. ShareCut API key as 'Bearer sc_live_...', required only by shorten_url (Business plan). create_qr works with no credentials at all.>"
}
}
}
}sharecut-mcpclaude mcp add sharecut-qr-short-links -e 'SHARECUT_API_KEY=<your sharecut_api_key>' -- npx -y sharecut-mcp@1.1.0{
"mcpServers": {
"sharecut-qr-short-links": {
"command": "npx",
"args": [
"-y",
"sharecut-mcp@1.1.0"
],
"env": {
"SHARECUT_API_KEY": "<your sharecut_api_key>"
}
}
}
}متغيرات البيئة
SHARECUT_API_KEYسري Optional. ShareCut API key (Business plan), needed only by shorten_url. Leave unset and create_qr still works.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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/mcpOr run this package over stdio:
npx sharecut-mcpConfig 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
الأسئلة الشائعة
ما هو ShareCut QR & Short Links؟
Short links you can re-point after printing the QR, with click analytics. Free QR, no key.
كيف أثبّت ShareCut QR & Short Links؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http sharecut-qr-short-links 'https://sharecut.site/mcp' --header 'Authorization: <Optional. ShareCut API key as '\''Bearer sc_live_...'\'', required only by shorten_url (Business plan). create_qr works with no credentials at all.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج ShareCut QR & Short Links إلى مفتاح API؟
نعم. يتطلب SHARECUT_API_KEY, Authorization، وتضبطها في إعداداته.
هل ShareCut QR & Short Links مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون ShareCut QR & Short Links؟
ينشره LucaRSdeCo. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.