# URL Shortener, Link Safety Scanner, QR Code Generator & Link Preview Metadata

### URL Shortener & Link Safety Scanner - MCP Server

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add clipi/url-shortener

# Browse available tools
npx -y @smithery/cli@latest tool list clipi/url-shortener

# Get full schema for a tool
npx -y @smithery/cli@latest tool get clipi/url-shortener shorten_url

# Call a tool
npx -y @smithery/cli@latest tool call clipi/url-shortener shorten_url '{}'
```

## Direct MCP Connection

Endpoint: `https://url-shortener--clipi.run.tools`

**Optional config:**
- `apikey` (query) — Your Clipi.cc API key. Get a free key by visiting https://clipi.cc/contact or emailing support@clipi.cc

## Tools (8)

- `shorten_url` — Shorten a long URL into a clean, short link. Supports optional custom slugs, password protection, expiry dates, click l…
- `get_link_details` — Get full details of a previously shortened link by its short code (urlKey). Returns the destination URL, creation date,…
- `list_all_links` — List all short links created with your API key. Returns an array of links with their details.
- `update_link` — Update a short link's destination URL, active status, or device routing (Android/iOS URLs). You can only update links y…
- `delete_link` — Permanently delete a short link. This action cannot be undone. You can only delete links you created.
- `preview_and_verify_url` — Scan a URL for safety threats, extract page metadata (title, description, image, favicon), check SSL certificate, follo…
- `get_link_analytics` — Get click analytics for a short link. Returns total clicks, unique visitors, country breakdown, device breakdown, brows…
- `generate_qr_code_url` — Get the URL to download a QR code image (PNG) for a short link. The returned URL can be embedded in documents, emails, …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get clipi/url-shortener <tool-name>
```

## Prompts (2)

- `scan_url_before_clicking` (url) — Scan any URL for safety threats, phishing, malware, and SSL issues before clicking or sharing it. Returns a full safety…
- `create_branded_campaign_link` (url, slug) — Create a branded short link with a custom slug, then generate a QR code for it. Perfect for marketing campaigns.
