mcpbeat

MiniURL MCP Server

io.github.addychang/miniurl
answering

MiniURL is answering right now. Last checked 13 min ago. It exposes 21 tools.

Create, manage, organize, and analyze short links with MiniURL's remote MCP server.

The linked repository no longer exists on GitHub — it was deleted or made private.

Uptime history 39 hours of history
39 hours agonow
100.0%
Uptime 24h
91 of 91 checks
21
Tools
read from the server
743 ms
Response time
average over 24h
open, no key
Access
streamable-http

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 13 min ago.

run in your terminal
claude mcp add miniurl --transport http https://workers.miniurl.com/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "miniurl": {
      "url": "https://workers.miniurl.com/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.miniurl]
url = "https://workers.miniurl.com/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "miniurl": {
      "url": "https://workers.miniurl.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "miniurl": {
      "url": "https://workers.miniurl.com/mcp"
    }
  }
}

Available tools 21

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

link
delete_link
Delete a registered short link permanently.
get_link
Get a single short link by alias for the current registered account.
get_link_stats
Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
update_link
Update a registered short link. Some fields require Pro.
tag
create_tag
Create a new tag for organising links. Maximum 20 tags per account.
delete_tag
Delete a tag and remove it from all associated links.
tag_link
Add a tag to a short link for campaign or category organisation.
account
get_account_status
Inspect the current guest/free/pro account status, remaining quota, and feature availability.
alias
check_alias
Check whether a custom alias is available on a given domain before creating a link.
authenticate
authenticate_token
Store an existing MiniURL token in the current MCP session. Accepts either a gt_ guest token or an mk_ API key.
bulk
bulk_create_links
Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
clear
clear_authentication
Clear any stored MiniURL authentication from the current MCP session.
domains
list_domains
List domains available to the current registered account, including miniurl.com and active custom domains.
guest
create_guest_token
Create a MiniURL guest token and store it in an unauthenticated MCP session. If auth is already set, keep it or call clear_authentication first. shorten_url can provision a guest automatically.
links
list_links
List short links for the current registered account.
send
send_registration_code
Send a 6-digit registration code to the user email, using the current guest session.
shorten
shorten_url
Create a short URL. If no authentication is set, MiniURL automatically starts a guest session for this MCP connection.
start
start_pro_upgrade
Create a shortened checkout link for upgrading the current registered account to Pro.
tags
list_tags
List all tags for the current registered account. Tags help organise links into campaigns or categories.
untag
untag_link
Remove a tag from a short link.
verify
verify_registration_code
Verify the emailed code, create the account, claim guest links, and replace the current guest auth with the new mk_ API key.

Endpoints

URLTransportStateLatencyChecked
https://workers.miniurl.com/mcp streamable-http answering 763 ms 13 min ago

MiniURL — questions

Answers built from our own checks of this server.

What can MiniURL do?
It exposes 21 tools, read directly from the server on our last check. Among them: authenticate_token, bulk_create_links, check_alias, clear_authentication, create_guest_token, create_tag and 15 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
What is MiniURL mostly used for?
Its tools cluster around link and tag. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.
Is MiniURL working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 743 ms. The bar chart above shows every period we have measured.
Is MiniURL still maintained?
The linked repository no longer exists on GitHub — it was deleted or made private. We show this because it changes what you can expect: an unmaintained server may keep answering for months and then stop without warning.
How do I connect MiniURL?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does MiniURL need an API key?
No. MiniURL completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 21 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is MiniURL?
It answers our handshake in 743 ms on average, which is faster than 10% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.