OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
Connect Remote server
claude mcp add --transport http miniurl https://workers.miniurl.com/mcp
{
"mcpServers": {
"miniurl": {
"url": "https://workers.miniurl.com/mcp"
}
}
}
{
"servers": {
"miniurl": {
"type": "http",
"url": "https://workers.miniurl.com/mcp"
}
}
}
Settings > Connectors > Add custom connector
URL: https://workers.miniurl.com/mcp
Tools 23 found in our last check
create_guest_tokenCreate a short-lived MiniURL guest bearer token. Legacy MCP sessions retain it; stateless clients must pass the returned gt_ token explicitly on later requests. shorten_url can provision one automatically.
clear_authenticationClear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
shorten_urlCreate a MiniURL short link for a supplied HTTP or HTTPS destination. Use when the user asks to shorten a URL or generate a MiniURL link. This is an additive external write; do not fetch or open the destination. If no authentication is supplied, MiniURL automatically starts a gu…
send_registration_codeSend a 6-digit registration code to the user email, using the current guest session.
verify_registration_codeVerify the emailed code, create the account, claim guest links, and continue with OAuth 2.1 + PKCE. Long-lived API keys are never returned over MCP.
get_account_statusInspect the current guest/free/pro account status, remaining quota, and feature availability.
start_pro_upgradeCreate a shortened checkout link for upgrading the current registered account to Pro.
list_domainsList the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.
add_domainRequest a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
delete_domainDelete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
verify_domainRefresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
list_linksList short links for the current registered account.
get_linkGet a single short link by alias for the current registered account.
update_linkUpdate a registered short link. Some fields require Pro.
delete_linkDelete a registered short link permanently.
bulk_create_linksCreate multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
get_link_statsGet link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
check_aliasCheck whether a custom alias is available on a given domain before creating a link.
list_tagsList all tags for the current registered account. Tags help organise links into campaigns or categories.
create_tagCreate a new tag for organising links. Maximum 20 tags per account.
delete_tagDelete a tag and remove it from all associated links.
tag_linkAdd a tag to a short link for campaign or category organisation.
untag_linkRemove a tag from a short link.
Details
| Endpoint | https://workers.miniurl.com/mcp (Streamable HTTP) |
| First published | 8 Aug 2026 |
| Last updated | 8 Aug 2026 |
| Registry name | io.github.addychang/miniurl |
More cloud and devops servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
