U301 URL Shortener

Effortlessly create clean, elegant links in bulk — powered by AI.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tealight-uk-u301-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@u301/mcp"
      ],
      "env": {
        "domain": "short.example.com",
        "API_KEY": "YOUR_API_KEY",
        "workspaceId": "workspace-1",
        "U301_API_KEY": "<Your-U301-API-Key>"
      }
    }
  }
}

You can run an MCP server to create short, memorable URLs by interacting with the U301 API. This MCP server lets you generate short links, optionally protecting them with a password, setting an expiration, and attaching comments for dashboard visibility.

How to use

To shorten a URL, you will use an MCP client to send a shorten request to your U301-based MCP server. You can specify the long URL, an optional slug for the short URL, an expiration time in seconds, a password to restrict access, and an optional comment that will appear in the Dashboard. After the request succeeds, you receive the short URL that redirects to your original link. You can reuse the same server setup to create many short URLs for different domains, users, or campaigns.

How to install

Prerequisites you need before installation: Node.js and npm installed on your system.

Follow these steps to set up and run the MCP server locally or in your environment.

Step 1 Create an API in U301 Dashboard to manage your short URLs.

Step 2 Optional: If you want to use your own domain for the short URLs, connect it through Cloudflare as part of the setup.

Step 3 Add this MCP Server config snippet to enable the U301 URL Shortener MCP server.

Additional notes

Configuration highlights include optional domain and workspaceId to tailor the short URL behavior to your environment. The environment variable you must provide is your U301 API key. If you have a custom domain, you can include it in the environment block; otherwise you can omit it.

{
  "mcpServers": {
    "u301-url-shortener": {
      "command": "npx",
      "args": [
        "-y",
        "@u301/mcp"
      ],
      "env": {
        "U301_API_KEY": <Your-U301-API-Key>
        // "domain": <if you have one, or you don't need to config>
      }
    }
  }
}