sharecut-mcp

# sharecut-mcp

MCP server for [ShareCut](https://sharecut.site) — generate QR codes and create
trackable short links from Claude, Cursor, or any MCP client.

**QR code generation is free and needs 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 `create_qr` still works.

</details>

## Tools

### `create_qr` — free, no API key

Renders any URL or text as a QR code. Returns SVG, and a PNG data URL if you ask
for `format: "png"`. Optional `color` as a hex value.

The code is **static**: the destination is encoded in the pattern itself, so once
it is printed it points there forever.

### `shorten_url` — requires an API key

Creates a ShareCut short link and a QR code that points at it. Because the QR
encodes the short link rather than the destination, you can **change where it goes
after it has been printed**, and every scan is counted — country, device, referrer.

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, and this one does.

Takes `url` and an optional `customCode`. Destinations are screened against Google
Safe Browsing before a link is created.

## API key

Only `shorten_url` needs one. 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 changes 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