Linkshrink Api

npm version Website API Status

Integrate LinkShrink into Claude, Cursor, VS Code, and any MCP-compatible AI assistant. Shorten URLs, retrieve click analytics, resolve shortened links, bulk shorten, and build UTM-tagged campaign URLs — all through natural language.

No API key required. Free forever.

Quick Start

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "linkshrink": {
      "command": "npx",
      "args": ["-y", "linkshrink-mcp"]
    }
  }
}

Then ask Claude:

"Shorten https://example.com/very/long/path/to/resource"

"Get click stats for code abc123"

"Unshorten https://bit.ly/3xYz"

Available Tools

Tool	Description
shorten_url	Shorten a URL with optional password protection, private stats, and preview page
get_url_stats	Get click statistics for a shortened URL (clicks, referrers, countries, daily breakdown)
unshorten_url	Resolve any shortened URL to its original destination with full redirect chain
bulk_shorten	Shorten multiple URLs at once in a single request
shorten_with_utm	Build UTM-tagged campaign URL and shorten it for marketing attribution

Architecture

Claude / Cursor / VS Code
        |
        | stdio (MCP protocol)
        v
  linkshrink-mcp
        |
        | HTTPS (REST API)
        v
  linkshrink.dev

This is a thin stdio MCP client that translates tool calls into REST API requests against the LinkShrink API at https://linkshrink.dev. No data is stored locally — all operations are stateless pass-throughs.

Configuration

Environment Variable	Default	Description
LINKSHRINK_API_URL	https://linkshrink.dev	API base URL (override for self-hosted instances)

SoftVoyagers Ecosystem

LinkShrink MCP is part of the SoftVoyagers portfolio of free developer APIs:

Product	Description	Website
LinkMeta	URL metadata extraction API	linkmeta.dev
PageShot	Screenshot & webpage capture API	pageshot.site
PDFSpark	HTML/URL to PDF conversion API	pdfspark.dev
OGForge	Open Graph image generator API	ogforge.dev
LinkShrink	Privacy-first URL shortener API	linkshrink.dev
Faktuj	Polish invoice generator	faktuj.pl · KSeF
QRMint	Styled QR code generator API	qrmint.dev · Docs · QR from URL
PageDrop	Instant HTML hosting API	pagedrop.dev
PismoSzyteNaMiarę	Document generator for Polish legal templates	pismoszytenamiare.pl · Umowa kupna-sprzedaży

License

MIT