Yourls MCP Server

Model Control Protocol server for YOURLS URL shortening

Remote serverstreamable-http

What is the Yourls MCP Server?

Yourls MCP connects Yourls MCP to AI assistants that speak the Model Context Protocol. Model Control Protocol server for YOURLS URL shortening.

What Yourls MCP does

A Model Control Protocol (MCP) server for integrating YOURLS URL shortening with Claude Desktop.

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.

Key capabilities

  • 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

Practical notes

  • Maintained by kesslerio.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Yourls MCP Server

{
  "mcpServers": {
    "yourls": {
      "command": "node",
      "args": [
        "/full/path/to/yourls-mcp/yourls-mcp.js"
      ],
      "env": {
        "YOURLS_API_URL": "https://your-yourls-domain.com/yourls-api.php",
        "YOURLS_AUTH_METHOD": "signature",
        "YOURLS_SIGNATURE_TOKEN": "YOUR_YOURLS_SIGNATURE_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
YOURLS_API_URLDeclared in the maintainer’s client configuration.Check documentation
YOURLS_AUTH_METHODDeclared in the maintainer’s client configuration.Check documentation
YOURLS_SIGNATURE_TOKENDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Yourls MCP to Installation.”
  • “Use Yourls MCP to Configuration.”

Frequently asked questions

Model Control Protocol server for YOURLS URL shortening Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.