koolink

Shorten any URL to a clean kool.ink/xyz link from your terminal. Free, unlimited, no signup. AI-agent ready.

npx @koolink/koolink https://example.com/very/long/path
# → https://kool.ink/abc123

Install

# one-off (no install)
npx @koolink/koolink https://example.com

# or install globally
npm install -g @koolink/koolink
koolink https://example.com

Usage

# Shorten a URL (prints the short link, copies to clipboard on desktop)
koolink https://example.com/very/long/path

# Shorten from stdin (great for piping)
echo "https://example.com" | koolink

# Shorten a batch
cat urls.txt | xargs -I{} koolink {}

Flag	Description
--help / -h	Show help
--version / -v	Show version

Install as an MCP server

Point any MCP client (Claude Desktop, Cursor, Windsurf, etc.) at the hosted MCP server at https://mcp.kool.ink — no API key required for anonymous shortening.

{
  "mcpServers": {
    "koolink": {
      "url": "https://mcp.kool.ink"
    }
  }
}

Tools

This server exposes the following MCP tools:

Tool	Description	Input
shorten_url	Shorten a long URL and return a compact kool.ink short link.	{ "url": "<long-url>" }

Why KooLink

• Free forever — no account, no credit card, no limits
• Clean, memorable URLs — kool.ink/xyz, not bit.ly/4xdK9qZ
• AI-agent ready — same service over MCP at https://mcp.kool.ink, or the REST API
• Analytics — every link is click-tracked with bot traffic filtered out
• Creator Earning Programme — as traffic grows, you earn

API

The CLI calls the public anonymous endpoint:

curl -X POST https://kool.ink/api/links \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

For AI agents, use the MCP server at https://mcp.kool.ink (no API key needed for anonymous shortening).

License

MIT