U301 URL Shortener
tealight-ukLABSCO SUMMARY
One job, one key.
There is nothing to configure past the API key: it shortens URLs through x.gd and stops there. That makes it easy to add and easy to reason about — the only thing it can reach is the shortener, with a key issued to an email address.
What it is
An MCP server for creating shortened URLs with the x.gd service. It gives an assistant a way to produce a short link while it is drafting, instead of sending you to a shortener in another tab.
What you get
- Shortened URLs created through x.gd, requested in the conversation where the link is being written
- A published npm package —
npx @hatimitu__hat/mcp-shoten-url— so nothing is built from source - Documented client entries for Claude Code (
~/.claude.json), Claude Desktop and VS Code, all with the same command and env block
Requirements
An x.gd API key in the XGD_API_KEY environment variable — the README links the x.gd developer page where you enter an email address to have one issued. Beyond that, Node with npx. The package is @hatimitu__hat/mcp-shoten-url, version 1.0.1.
Setup effort
One command plus a key — npx @hatimitu__hat/mcp-shoten-url, then supply credentials
USE CASES
01
Shortening a link while drafting
Ask for a short URL in the middle of writing a post or message rather than switching to a shortener.
02
Keeping links tidy in generated content
Have the assistant shorten each long URL as it assembles a message, so the output arrives ready to send.
03
Using one shortener across editors
Register the same npx command in Claude Code, Claude Desktop or VS Code and get the same links from any of them.
BEFORE YOU INSTALL
What to know first
Requires
- npx on PATH
- XGD_API_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @hatimitu__hat/mcp-shoten-urlMCP Clients
Claude Code, Claude Desktop
JSON
{
"mcpServers": {
"shoten-url": {
"command": "npx",
"args": [
"@hatimitu__hat/mcp-shoten-url"
],
"env": {
"XGD_API_KEY": "<YOUR_XGD_API_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"shoten-url": {
"command": "npx",
"args": [
"@hatimitu__hat/mcp-shoten-url"
],
"env": {
"XGD_API_KEY": "<YOUR_XGD_API_KEY>"
}
}
}
}
