Question 1

What is YOURLS-MCP?

Accepted Answer

YOURLS-MCP is a Model Control Protocol (MCP) server that integrates YOURLS URL shortening with Claude Desktop, allowing you to shorten URLs directly within Claude.

Question 2

How does YOURLS-MCP work?

Accepted Answer

It acts as a bridge between Claude Desktop and your self-hosted YOURLS instance, enabling Claude to send URL shortening requests and receive shortened URLs in response.

Question 3

What are the key features of YOURLS-MCP?

Accepted Answer

Key features include seamless Claude integration, custom keyword support, duplicate URL handling, comprehensive URL statistics, and plugin-based extensibility.

Question 4

What is the Duplicate URL Handling feature in YOURLS-MCP?

Accepted Answer

This feature allows you to create multiple short URLs for the same destination URL, which is not natively supported in YOURLS. This is useful for A/B testing and targeted campaigns.

Question 5

How does YOURLS-MCP handle duplicate URLs?

Accepted Answer

YOURLS-MCP supports two approaches for handling duplicate URLs: the Plugin Approach (recommended), which uses the included Force Allow Duplicates plugin to create true duplicate URLs, and the URL Modification Approach (fallback), which adds timestamp parameters to make each URL technically unique.

Question 6

What are the benefits of using YOURLS-MCP?

Accepted Answer

Benefits include increased productivity, improved branding consistency, enhanced marketing campaign tracking, and better control over your URL shortening process.

Question 7

How do I install YOURLS-MCP?

Accepted Answer

1. Clone the repository from GitHub. 2. Install the dependencies using `npm install`. 3. Configure Claude Desktop to point to your YOURLS-MCP installation.

Question 8

How do I configure YOURLS-MCP?

Accepted Answer

You configure YOURLS-MCP by setting environment variables in your Claude Desktop configuration file. These variables include your YOURLS API URL, authentication method, and signature token.

Question 9

What environment variables are required for YOURLS-MCP?

Accepted Answer

The required environment variables are `YOURLS_API_URL` and, depending on the authentication method, either `YOURLS_SIGNATURE_TOKEN` (for signature auth) or `YOURLS_USERNAME` and `YOURLS_PASSWORD` (for password auth).

Question 10

What is the Model Context Protocol (MCP)?

Accepted Answer

MCP is an open protocol that standardizes how applications provide context to LLMs, allowing AI models to access and interact with external data sources and tools.

Question 11

What are the available MCP tools in YOURLS-MCP?

Accepted Answer

YOURLS-MCP provides tools for shortening URLs (`shorten_url`), expanding URLs (`expand_url`), getting URL statistics (`url_stats`), getting database statistics (`db_stats`), and creating custom URLs (`create_custom_url`).

Question 12

What is UBOS?

Accepted Answer

UBOS is a full-stack AI Agent Development Platform that helps businesses orchestrate AI Agents, connect them with enterprise data, build custom AI Agents with their LLM model, and create Multi-Agent Systems.

Question 13

How does YOURLS-MCP relate to UBOS?

Accepted Answer

YOURLS-MCP is available on the UBOS Asset Marketplace as a tool that enhances AI workflows by integrating URL shortening capabilities into Claude Desktop.

Question 14

Can I use YOURLS-MCP with plugins?

Accepted Answer

Yes, YOURLS-MCP is designed to work with various YOURLS plugins, providing enhanced functionality such as detailed analytics, URL updating, and QR code generation.

Question 15

What happens if a required plugin is not installed?

Accepted Answer

YOURLS-MCP includes intelligent fallbacks for extended functionality when plugins are not installed. If a plugin is missing, it will attempt to use the core YOURLS API to provide a basic level of functionality.

Question 16

What is the Force Allow Duplicates plugin?

Accepted Answer

The Force Allow Duplicates plugin is a custom plugin that bypasses YOURLS' unique URL constraint, allowing you to create multiple short URLs for the same destination URL.

Question 17

How do I install the Force Allow Duplicates plugin?

Accepted Answer

1. Download the plugin from the plugin repository (coming soon). 2. Copy the `force-allow-duplicates` folder to your `YOURLS/user/plugins/` directory. 3. Activate the plugin in your YOURLS admin interface.

Question 18

How can I test YOURLS-MCP?

Accepted Answer

The project includes various test scripts in the `tests/integration/` directory that you can run using Node.js.

Question 19

Where can I find support for YOURLS-MCP?

Accepted Answer

You can find support and report issues on the YOURLS-MCP GitHub repository: https://github.com/kesslerio/yourls-mcp/issues.

Question 20

What is URL modification and when is it used?

Accepted Answer

URL modification is a fallback approach in YOURLS-MCP that adds a timestamp parameter to a URL to make it unique in the database, allowing multiple short URLs to point to the same destination even if YOURLS does not natively support duplicates. It is used when the Force Allow Duplicates plugin is not installed or enabled.

YOURLS URL Shortener Integration Server

Resources

Project Details

Recomended MCP Servers

Featured Templates

Pharmacy Admin Panel

AI-Powered Essay Outline Generator

Sarcastic AI Chat Bot

Python Bug Fixer

Unified Authorization Template

Service ERP

Start your free trial