ShareCut QR & Short Links
Short links you can re-point after printing the QR, with click analytics. Free QR, no key.
Open source Repository Open in the app JSON README (API)
About
Short links you can re-point after printing the QR, with click analytics. Free QR, no key.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- lucarsdeco
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.1.0
- Last push
- 2026-08-31T12:03:10Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:01
- Updated
- 2026-08-31 10:00:07
- Origin id
io.github.LucaRSdeCo/sharecut-mcp
README
# sharecut-mcp
MCP server for [ShareCut](https://sharecut.site) — 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:
```bash
claude mcp add --transport http sharecut https://sharecut.site/mcp
```
Or run this package over stdio:
```bash
npx sharecut-mcp
```
<details>
<summary>Config file (Claude Desktop, Cursor, …)</summary>
```json
{
"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.
</details>
## 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](https://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](https://sharecut.site/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