YOURLS-MCP
About
Model Control Protocol (MCP) server for YOURLS URL shortening integration with Claude Desktop
Details
- Author
- kesslerio
- Downloads
- 126
- Categories
- Productivity, Web Scraping, Other
Jump to
- 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)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
YOURLS-MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"yourls-mcp": {
"yourls-mcp": {
"command": "node",
"args": [
"yourls-mcp.js"
]
}
}
}
}McpServers
{
"yourls-mcp": {
"command": "node",
"args": [
"yourls-mcp.js"
]
}
}YOURLS-MCP
A Model Control Protocol (MCP) server for integrating YOURLS URL shortening with Claude Desktop.
Author: Martin Kessler
Overview
YOURLS-MCP creates a bridge between Claude Desktop and your self-hosted YOURLS URL shortener instance. When configured, it allows Claude to automatically shorten URLs using your personal YOURLS installation.
Features
- Shorten URLs using your YOURLS instance
- Create custom short URLs with specific keywords
- Duplicate URL Handling: Create multiple short URLs for the same destination URL (unique to YOURLS-MCP)
- Expanded URL information and statistics
- Database statistics
- Intelligent fallbacks for plugins
- Comprehensive documentation and testing tools
Quick Start
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
