YOURLS-MCP

Name: YOURLS-MCP
Author: kesslerio

@kesslerio

Repository

About YOURLS-MCP

Model Control Protocol (MCP) server for YOURLS URL shortening integration with Claude Desktop

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "yourls-mcp": {
      "command": "node",
      "args": [
        "yourls-mcp.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is YOURLS-MCP?

YOURLS-MCP is a Model Context Protocol (MCP) server that integrates your self-hosted YOURLS URL shortener with Claude Desktop. It acts as a bridge, allowing Claude to shorten, expand, and manage URLs through your personal YOURLS instance.

How to use YOURLS-MCP?

Clone the repository, install dependencies with npm install, then configure Claude Desktop by adding a YOURLS-MCP entry to its config.json file with environment variables such as YOURLS_API_URL, YOURLS_AUTH_METHOD, and YOURLS_SIGNATURE_TOKEN. Once configured, Claude automatically uses the provided MCP tools when given URL-related prompts.

Key features of YOURLS-MCP

Shorten long URLs using your YOURLS instance
Create custom short URLs with specific keywords
Create multiple short URLs for the same destination URL
Expand short URLs to see their original destination
Retrieve click statistics for individual short URLs
View global statistics for your YOURLS instance
Shorten URLs with Google Analytics UTM tracking parameters
Plugin-based tools for advanced URL management (requires additional YOURLS plugins)

Use cases of YOURLS-MCP

Quickly shorten a long URL through a natural language prompt to Claude
Create branded short links with custom keywords for marketing campaigns
Add UTM tracking parameters to shortened URLs for analytics
Retrieve click counts and detailed analytics for existing short URLs
Manage and search your YOURLS database, including listing, updating, and deleting short URLs