Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@cliqo/mcp shorten https://example.com to mylink"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol server for cliqo.link — a pay-per-use (credits) link shortener.
It lets any MCP client (Claude Desktop, Claude Code, etc.) create short links, list/get/revoke them, and check your remaining credit balance.
The server is a thin wrapper over the public cliqo v1 REST API — see the machine-readable reference at https://cliqo.link/llms.txt.
Node.js >= 18
A cliqo API key. Create one in the dashboard under API keys — it is shown only once. The key's scopes determine which tools work:
links:read — list_links, get_link
links:write — shorten_url
links:delete — delete_link
billing:read — get_credits
Related MCP server: Firelinks MCP Server
Tool | Description | Scope |
| Create a short link for a URL. Consumes one credit. |
|
| List your links (newest first). Optionally include revoked links or filter by tag. |
|
| Fetch a single link by its numeric id. |
|
| Revoke (delete) a link by id. Cannot be undone. |
|
| Check how many link credits remain. |
|
Set the CLIQO_API_KEY environment variable to your API key. The server speaks MCP over stdio.
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"cliqo": {
"command": "npx",
"args": ["-y", "@cliqo/mcp"],
"env": {
"CLIQO_API_KEY": "your-api-key"
}
}
}
}claude mcp add cliqo --env CLIQO_API_KEY=your-api-key -- npx -y @cliqo/mcpCLIQO_API_KEY=your-api-key npx -y @cliqo/mcpVariable | Required | Description |
| yes | Your cliqo API key, sent as a Bearer token. |
npm install
npm run build # compile TypeScript to dist/
npm run watch # recompile on change
npm start # run the built serverThe source lives in src/:
client.ts — thin HTTP client for the cliqo REST API.
index.ts — MCP server wiring and tool definitions.
MIT
Revoke (delete) a short link by its numeric id. The short URL stops resolving. This cannot be undone.
Inputs: id (required).
Check how many link credits remain on your account.
Inputs: no named parameters.
Fetch a single short link by its numeric id.
Inputs: id (required).
List your short links (newest first). By default only active links are returned.
Inputs: tag, includeRevoked.
Create a short link for a URL. Consumes one credit. Returns the created link including its short URL and id.
Inputs: url (required), name, utmSource, utmCampaign.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool has a clearly distinct purpose: delete, get credits, get a single link, list links, and shorten a URL. No overlap or ambiguity.
All tool names follow a consistent verb_noun snake_case pattern (e.g., delete_link, list_links, shorten_url), making them predictable and easy to understand.
With 5 tools, the set is well-scoped for a URL shortener service, covering the essential operations without being excessive or insufficient.
The tools provide complete CRUD for links (create, read, list, delete) plus a credit check, leaving no obvious gaps for the domain.
Create and manage short links, track clicks, and automate URL management
Create short links and see their click counts from your AI assistant.
Short links, QR codes, link and website analytics: create and edit links, read clicks and visitors.
Short links with QR, custom domains and bot-free click analytics. Create, edit, delete, analyze.
