Skip to main content
Glama
Sign In
enesjakozh
URL Shortener MCP

URL Shortener MCP

by Talismanic
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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.

Related MCP server: MCP Website Fetcher

🚀 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]'

Docker Installation:

docker build -t url-shortener .

3. Running

uv run main.py

For docker based use, we dont need to do anything here.

4. Adding in Claude Desktop

With the uv

{
  "mcpServers": {
    "url-shortener": {
      "command": "/Users/{userName}/.local/bin/uv",
      "args": [
        "--directory",
        "{path_to_repo}/cleanuri-url-shortener-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

With Docker

{
  "mcpServers": {
    "url-shortener": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "url-shortener"
      ]
    }
  }
}

Available Tools

1 tool
shortenB

Shorten a URL using the cleanuri API.

Args:
    original_url: The URL to shorten.

Inputs: original_url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3.3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'shorten' has a single, clear purpose that cannot be confused with any other tool in this set.

    Naming Consistency5/5

    Since there is only one tool, naming consistency is inherently perfect. The tool name 'shorten' follows a clear verb-based pattern appropriate for its function, with no other tools to compare against for inconsistency.

    Tool Count2/5

    A single tool for a URL shortener server is too few for the apparent scope, as it only covers shortening URLs without any complementary operations like retrieving, updating, deleting, or listing shortened URLs. This minimal set limits functionality and may cause agent failures in broader workflows.

    Completeness2/5

    The tool surface is severely incomplete for a URL shortener domain. While 'shorten' allows creation, there are no tools for retrieving, updating, deleting, or managing shortened URLs (e.g., get_url, list_urls, delete_url), creating significant gaps that will hinder agent performance in typical use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Rebrandly MCP

      Rebrandly MCPofficial

      rebrandly
      A
      license
      Not graded
      quality
      F
      maintenance
      This project implements a simple MCP server in Go that exposes a single tool (create_short_link) to generate short URLs using the Rebrandly API.
      MIT

    • MCP Website Fetcher

      electrocucaracha
      F
      license
      Not graded
      quality
      F
      maintenance
      A lightweight MCP server implementation that provides a simple tool for fetching website content, demonstrating how tools can be exposed and interacted with using the MCP protocol.
      -

    • ShortURLMCP

      AceDataCloud
      A
      license
      A
      quality
      B
      maintenance
      An MCP server that enables users to shorten long URLs into permanent, shareable links using the AceDataCloud API. It supports both single and batch URL shortening directly within MCP-compatible clients like Claude and VS Code.
      4
      1
      MIT