clipi/url-shortener### URL Shortener & Link Safety Scanner - MCP Server The complete **URL management and link security toolkit** for AI agents. Shorten URLs, scan links for safety threats, inspect SSL certificates, follow redirect chains, track click analytics, and generate QR codes all through 8 powerful MCP tools. Built for AI agents, chatbots, and LLM-powered workflows that need to safely interact with URLs on the internet. --- #### 🔗 Tool 1: `shorten_url` - URL Shortener API Create **short links** and **branded URLs** with a single tool call. Supports custom slugs (e.g., `clipi.cc/my-brand`), password-protected links, expiration dates, click limits, and Android/iOS deep linking. Every URL is validated against **Google Safe Browsing** and a domain blacklist before shortening. **Keywords:** url shortener, link shortener, short url generator, custom short link, branded url, url shortening api, shorten link, tiny url, bit.ly alternative --- #### 🔍 Tool 2: `preview_and_verify_url` - URL Safety Scanner & Link Preview The most comprehensive **URL scanning tool** available via MCP. Analyzes any URL and returns: - **Link Preview Metadata** - title, description, Open Graph image, site name, domain, favicon - **Safety Verdict** - Google Safe Browsing threat detection, domain blacklist check, accessibility verification - **SSL Certificate Inspection** - issuer, organization, validity dates, TLS protocol version - **Redirect Chain Analysis** - final destination URL, redirect count, response time, content type detection - **Shortened URL Detection** - identifies links from 50+ URL shortener services (bit.ly, t.co, goo.gl, etc.) Use this tool to **verify unknown links before clicking**, detect **phishing URLs**, identify **malware links**, and extract **Open Graph metadata** for previews. **Keywords:** url scanner, link checker, phishing detection, malware url scanner, url safety check, link preview api, open graph metadata, ssl checker, redirect tracker, url verification, link validator, safe browsing api, url reputation check, website safety scanner, suspicious link checker, anti-phishing tool --- #### 📊 Tool 3: `get_link_analytics` - Link Click Analytics & Tracking Get real-time **click analytics** for any shortened link. Returns total clicks, unique visitors, country breakdown, device type breakdown (desktop/mobile/tablet), browser breakdown (Chrome/Safari/Firefox), and a detailed **recent click activity feed** with timestamps, locations, device types, and referrers. **Keywords:** link analytics api, click tracking, url analytics, link click counter, link tracking api, click statistics, url performance tracker, link monitoring --- #### 📋 Tool 4: `get_link_details` - Link Information Lookup Retrieve full details of any shortened link - destination URL, creation date, preview metadata (title, description, image), custom slug, expiry settings, password protection status, click limits, active/inactive status, and security flags. **Keywords:** link details api, url info lookup, short url details, link metadata, url information retrieval --- #### 📝 Tool 5: `list_all_links` - List & Manage All Links List all short links created under your API key. Returns complete details for every link, enabling AI agents to browse, audit, and manage an entire link portfolio programmatically. **Keywords:** link management api, list all urls, url manager, bulk link lookup, link inventory --- #### ✏️ Tool 6: `update_link` - Update Link Destination & Settings Update a short link's destination URL, active/inactive status, or device-specific redirect URLs (Android/iOS deep links). URL changes are re-validated for safety automatically. Ownership enforcement ensures you can only update your own links. **Keywords:** update short link, change url destination, link editor api, modify short url, url redirect update --- #### 🗑️ Tool 7: `delete_link` - Delete Short Links Permanently delete a short link. Ownership enforcement ensures you can only delete links you created. Returns confirmation with the deleted URL key. **Keywords:** delete short link api, remove url, link deletion, url cleanup --- #### 📱 Tool 8: `generate_qr_code_url` - QR Code Generator Generate a **downloadable QR code image** (PNG) for any short link. Customize the image size (50–1000px). Returns a direct URL to the QR code that can be embedded in documents, emails, presentations, or web pages. **Keywords:** qr code generator api, qr code for url, qr code maker, generate qr code, qr code image api, dynamic qr code, qr code creator --- ### Authentication Two authentication methods: 1. **Server-Level API Key** - Set the `MCP_API_KEY` environment variable when configuring the MCP server. All tool calls are auto-authenticated. 2. **Per-Call API Key** - Pass your `apikey` as a tool parameter on each call. Useful when multiple users share one MCP server. Get your free API key at [clipi.cc](https://clipi.cc) or email us [email protected] --- ### Use Cases for AI Agents | Use Case | Tools Used | |----------|-----------| | "Shorten this URL and give me a QR code" | `shorten_url` → `generate_qr_code_url` | | "Is this link safe to click?" | `preview_and_verify_url` | | "Check if anyone clicked my link" | `get_link_analytics` | | "Create a branded campaign link with tracking" | `shorten_url` (custom slug) → `get_link_analytics` | | "Scan this shortened bit.ly link before opening" | `preview_and_verify_url` | | "List all my active links and deactivate expired ones" | `list_all_links` → `update_link` | --- ### Tags (for Smithery search & categories) ``` url-shortener, link-scanner, url-safety, phishing-detection, link-preview, qr-code, click-analytics, ssl-checker, redirect-tracker, url-verification, link-management, open-graph, malware-scanner, link-tracking, safe-browsing, branded-links, url-intelligence, web-security ``` ### Categories ``` Security, Data, Productivity, Web ```