YOURLS-MCP

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.)