@cliqo/mcp

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.

Prerequisites

• 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: DWZ Short URL MCP Server

Tools

Usage

Set the CLIQO_API_KEY environment variable to your API key. The server speaks MCP over stdio.

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "cliqo": {
      "command": "npx",
      "args": ["-y", "@cliqo/mcp"],
      "env": {
        "CLIQO_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add cliqo --env CLIQO_API_KEY=your-api-key -- npx -y @cliqo/mcp

Run directly

CLIQO_API_KEY=your-api-key npx -y @cliqo/mcp

Environment variables

Development

npm install
npm run build      # compile TypeScript to dist/
npm run watch      # recompile on change
npm start          # run the built server

The source lives in src/:

• client.ts — thin HTTP client for the cliqo REST API.

• index.ts — MCP server wiring and tool definitions.

License

MIT