{
  "markdown": "# sharecut-mcp\n\nMCP server for [ShareCut](https://sharecut.site) — generate QR codes, create\ntrackable short links, **re-point them after the QR is printed**, and read their\nclick analytics from Claude, Cursor, or any MCP client.\n\n**QR codes, link expansion and short-code checks are free and need no account.**\n\n## Install\n\nRemote server, nothing to install:\n\n```bash\nclaude mcp add --transport http sharecut https://sharecut.site/mcp\n```\n\nOr run this package over stdio:\n\n```bash\nnpx sharecut-mcp\n```\n\n<details>\n<summary>Config file (Claude Desktop, Cursor, …)</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"sharecut\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"sharecut-mcp\"],\n      \"env\": { \"SHARECUT_API_KEY\": \"sc_live_...\" }\n    }\n  }\n}\n```\n\n`SHARECUT_API_KEY` is optional — leave it out and the three free tools still work.\n\n</details>\n\n## Free tools — no API key, no account\n\n| Tool | What it does |\n|---|---|\n| `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. |\n| `expand_short_link` | Resolves a `sharecut.site` short link to its real destination and click count, without opening it. |\n| `check_short_code` | Tells you whether a custom short code is still free before you try to claim it. |\n\n## Tools that need an API key\n\nThe interesting half. All of them act on the account the key belongs to.\n\n### `update_link` — the reason this server exists\n\nChanges where an existing short link points. A ShareCut QR encodes the **short\nlink**, not the destination, so re-pointing the link redirects every copy already\nprinted, shared or stuck on a wall — and the click history comes along.\n\nThat difference is the whole point. A poster, a menu, a business card or a product\nlabel outlives the URL printed on it. A static QR does not survive a site\nmigration or a campaign change; this one does.\n\nThe short code itself is deliberately immutable here: changing it would break\nevery copy already in circulation.\n\n### The rest\n\n| Tool | What it does |\n|---|---|\n| `shorten_url` | Creates a short link plus its QR code. Optional `customCode`, `title` and `utm`. Destinations are screened against Google Safe Browsing. |\n| `shorten_urls_bulk` | Up to 25 links in one call, with per-item results so one bad URL does not discard the rest. |\n| `list_links` | Lists your links with click counts — filter by kind or search term, sort by newest or most clicked. |\n| `get_link` | Destination, title, clicks, creation date and UTM settings for one link. |\n| `get_link_analytics` | Clicks over time, plus breakdowns by country, device, OS, browser and referrer. |\n| `get_link_qr` | The QR code of an existing link, using the artwork saved on it (frames, colours, logo) when there is one. |\n| `delete_link` | Permanent, and it releases the short code. Needs an explicit `confirm`. |\n| `get_account` | Plan, entitlements and how much API quota is left this month. Worth calling before a bulk run. |\n\n## API key\n\nCreate it at [sharecut.site/p/profile](https://sharecut.site/p/profile) — API\naccess is part of the Business plan — then pass it as `SHARECUT_API_KEY`.\n\nThere is no programmatic sign-up: a person creates the key. See\n[auth.md](https://sharecut.site/auth.md) for the full authentication contract.\n\n## How it works\n\nThis package is a thin stdio bridge to `https://sharecut.site/mcp`. It moves\nnewline-delimited JSON-RPC to that endpoint and back, which means **zero\ndependencies** (fast `npx` start) and no upgrades to chase: the tools live on the\nserver, so new ones reach you without touching your config.\n\nPoint `SHARECUT_MCP_URL` elsewhere to target a different deployment.\n\n## Links\n\n- Documentation — <https://sharecut.site/p/api/>\n- OpenAPI — <https://sharecut.site/openapi.json>\n- Server card — <https://sharecut.site/.well-known/mcp/server-card.json>\n\nMIT\n",
  "bytes": 3949,
  "sha": "f0f5c216be0a0879561834953dd05fab7565c369a2149a8227d1fe1dcee70850",
  "repo_slug": "lucarsdeco/sharecut-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lucarsdeco_sharecut_mcp_b916d098/readme"
}