U301 MCP Server

MCP server for interacting with U301 URL Shortener

Local serverstdio

What is the U301 MCP MCP server?

U301 MCP becomes available to MCP clients through the u301 mcp mcp server. MCP server for interacting with U301 URL Shortener.

Tools it exposes

Once connected, the assistant can call these 8 tools directly:

  • url — The URL to shorten
  • slug — (optional) The slug of the URL
  • expiredAt — (optional) The expiration date for the URL, for example 2026-03-13T00:00:00Z
  • password — (optional) The password to access the URL
  • comment — (optional) The comment to display in Dashboard
  • U301_API_KEY — The U301 API key, required for creating short URLs
  • DOMAIN — (optional) The short URL domain, leave blank for the default domain
  • WORKSPACE_ID — (optional) Which workspace to use, leave blank for the default workspace

Installing the u301 mcp mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 3 environment variables: U301_API_KEY, DOMAIN, WORKSPACE_ID. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. U301 MCP sits in that group, and the shape of its toolset — url, slug, expiredAt among others — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • With 8 tools exposed, expect a noticeable bump in prompt size — disable it in projects that never use U301 MCP.
  • Maintained by tealight-uk.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the u301 mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
urlThe URL to shorten
slug(optional) The slug of the URL
expiredAt(optional) The expiration date for the URL, for example 2026-03-13T00:00:00Z
password(optional) The password to access the URL
comment(optional) The comment to display in Dashboard
U301_API_KEYThe U301 API key, required for creating short URLs
DOMAIN(optional) The short URL domain, leave blank for the default domain
WORKSPACE_ID(optional) Which workspace to use, leave blank for the default workspace

How to install the U301 MCP MCP server

{
  "mcpServers": {
    "u301-url-shortener": {
      "command": "npx",
      "args": [
        "-y",
        "@u301/mcp"
      ],
      "env": {
        "U301_API_KEY": "<Your-U301-API-Key>",
        // "DOMAIN": "<optional-custom-domain>",
        // "WORKSPACE_ID": "<optional-workspace-id>"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
U301_API_KEYCredential the server authenticates with.Yes
DOMAINConfiguration value read at startup.Optional
WORKSPACE_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use U301 MCP to url.
  • Use U301 MCP to slug.
  • Use U301 MCP to expiredAt.

Frequently asked questions

It connects U301 MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (url, slug, expiredAt, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with U301 MCP directly.