MCP.so
Sign In

YOURLS-MCP

@kesslerio

Repository

About YOURLS-MCP

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

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

FAQ from YOURLS-MCP

—

(No FAQ section is present in the README.)

Comments

Basic information

Category

Other

Transports

stdio

Author

kesslerio

More Other MCP servers

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K