KooLink MCP server
Commit Sep 1, 2026Shortens long URLs into compact kool.ink links for use by AI agents and developers.
Also known as KooLink/koolink-cli, koolink-cli
- Stars
- 0
- Tools
- 1
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Sep 1, 2026
- License
- MIT
What is KooLink MCP?
KooLink shortens long URLs into compact kool.ink links for use by AI agents and developers. It exposes 1 tool, such as shorten_url.
Summary generated from the project's README
About KooLink MCP server
Transforming long, cumbersome web addresses into compact kool.ink links is what this service enables for developers and AI agents. By connecting your MCP client like Claude Desktop, Cursor, or Windsurf to the hosted server, you can use the shorten_url tool to generate clean links without needing an account or an API key.
This tool works through a remote connection to a hosted endpoint, allowing for anonymous shortening. It is designed to be used directly within AI workflows to provide memorable URLs that include click-tracking with bot traffic filtered out. Unlike many other services, it offers unlimited shortening for free and does not require a signup or credit card to function.
What you can do with it
- 1Shorten URLs within AI chatsAn AI agent can take a long web address and return a compact link for a user.
- 2Automate link creation in workflowsYou can use the command line to shorten URLs from standard input.
Written from the project's README. Every use case is checked against a quote from it.
How to install KooLink MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall KooLink MCP in Claude Code
$ claude mcp add --transport http koolink-cli https://mcp.kool.ink/Install KooLink MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"koolink-cli": {
"url": "https://mcp.kool.ink/"
}
}
}Install KooLink MCP in VS Code
.vscode/mcp.json
{
"servers": {
"koolink-cli": {
"type": "http",
"url": "https://mcp.kool.ink/"
}
}
}Install KooLink MCP in VS Code CLI
$ code --add-mcp '{"name":"koolink-cli","type":"http","url":"https://mcp.kool.ink/"}'Install KooLink MCP in Codex
$ codex mcp add koolink-cli --url https://mcp.kool.ink/Install KooLink MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.koolink-cli] url = "https://mcp.kool.ink/"
Install KooLink MCP in Gemini CLI
$ gemini mcp add -s user --transport http koolink-cli https://mcp.kool.ink/Install KooLink MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"koolink-cli": {
"url": "https://mcp.kool.ink/",
"type": "http"
}
}
}KooLink MCP tools 1
Detected from the READMEshorten_url
| shorten_url | — |
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekoolink/koolink-cli is public and reachablegithub.com/koolink/koolink-cli ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-09github.com/koolink/koolink-cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model1 tool description and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2024-11-05 in 1221 msPass
README
View on GitHubkoolink
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, notbit.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
KooLink MCP questions
How do I add KooLink MCP to Claude Code?
Run claude mcp add --transport http koolink-cli https://mcp.kool.ink/ in your terminal. Add --scope user to make it available in every project.
How do I add KooLink MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does KooLink MCP provide?
It exposes 1 tool, including shorten_url.
Do I need an API key to use KooLink?
No, no API key is required for anonymous shortening.
Is there a limit to how many URLs I can shorten?
The service is free and offers unlimited shortening with no signup required.