URL Shortener MCP

by Talismanic
Verified

URL Shortener MCP Tool

This project provides a simple URL shortening tool using the CleanURI API and is designed to run as a FastMCP server tool.

✨ Features

  • Shortens any given URL using the CleanURI API.
  • Exposes the functionality as a tool via FastMCP.
  • Includes proper error handling and response validation.
  • Designed to run via stdio transport for integration with agent or tool-based systems.

🚀 Usage

1. Requirements

  • Python 3.10+
  • httpx
  • fastmcp

2. Installation

Installing via Smithery

To install URL Shortener Tool for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Talismanic/cleanuri-url-shortener-mcp --client claude

Manual Installation

uv add httpx 'mcp[cli]'

3. Running

uv run main.py

4. Adding in Claude Desktop

{ "mcpServers": { "url-shortener": { "command": "/Users/mohammedmehedihasan/.local/bin/uv", "args": [ "--directory", "/Users/mohammedmehedihasan/personal/codes/mcp-servers/cleanuri-url-shortener-mcp", "run", "main.py" ] } } }```
-
security - not tested
F
license - not found
-
quality - not tested

A simple tool that shortens URLs using the CleanURI API, designed to integrate with FastMCP server for agent systems.

  1. ✨ Features
    1. 🚀 Usage
      1. 1. Requirements
      2. 2. Installation
      3. Installing via Smithery
      4. Manual Installation
      5. 3. Running
      6. 4. Adding in Claude Desktop