MiniURL

Name: MiniURL
Author: addychang

MCP serverMCP

OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.

by addychangrepository ↗homepage ↗v1.2.0

Is this yours?

This record is unclaimed

Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.

Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"miniurl","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.

Claim this record

Observed by Wellknown

Evidence

Everything here was measured by our prober or read from a registry. Nothing is self-reported.

30-day availability4/4 checks ok

30 days agotoday

when	check	result	http	latency	detail
6 h ago	mcp initialize	ok	200	555 ms	server MiniURL MCP 1.3.0 · protocol 2025-06-18 · 23 tools
13 h ago	mcp initialize	ok	200	365 ms	server MiniURL MCP 1.3.0 · protocol 2025-06-18 · 23 tools
21 h ago	mcp initialize	ok	200	355 ms	server MiniURL MCP 1.3.0 · protocol 2025-06-18 · 23 tools
27 h ago	mcp initialize	ok	200	363 ms	server MiniURL MCP 1.3.0 · protocol 2025-06-18 · 23 tools
34 h ago	mcp initialize	ok	200	338 ms	server MiniURL MCP 1.3.0 · protocol 2025-06-18 · 23 tools
2 d ago	mcp initialize	ok	200	354 ms	server MiniURL MCP 1.3.0 · protocol 2025-06-18 · 23 tools

Tools observed via MCP handshake

create_guest_token — Create a short-lived MiniURL guest bearer token. Legacy MCP sessions retain it; stateless clients must pass the returned gt_ token explicitly on later requests.
clear_authentication — Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
shorten_url — Create 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 ex
send_registration_code — Send a 6-digit registration code to the user email, using the current guest session.
verify_registration_code — Verify 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_status — Inspect the current guest/free/pro account status, remaining quota, and feature availability.
start_pro_upgrade — Create a shortened checkout link for upgrading the current registered account to Pro.
list_domains — List domains available to the current registered account, including miniurl.com and active custom domains.
add_domain — Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
delete_domain — Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
verify_domain — Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
list_links — List short links for the current registered account.
get_link — Get a single short link by alias for the current registered account.
update_link — Update a registered short link. Some fields require Pro.
delete_link — Delete a registered short link permanently.
bulk_create_links — Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
get_link_stats — Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
check_alias — Check whether a custom alias is available on a given domain before creating a link.
list_tags — List all tags for the current registered account. Tags help organise links into campaigns or categories.
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.
untag_link — Remove a tag from a short link.

Declared by sources

What the publisher says

Attributed to the source that supplied each field. Treated as claims, not facts.

No long description beyond the summary.

kind ← Official MCP Registry

name ← Official MCP Registry

repoUrl ← Official MCP Registry

summary ← Official MCP Registry

version ← Official MCP Registry

description ← Official MCP Registry

homepageUrl ← Official MCP Registry

publisherName ← Official MCP Registry

Provenance

Where this record came from

Every source is kept verbatim. Field changes are logged as events.

Official MCP Registryio.github.addychang/miniurl

first seen 2 d ago · fetched 2 d agoopen ↗

Field history (7 recent events)

2 d ago · declared · summary → "OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation."
2 d ago · declared · description → "OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation."
2 d ago · declared · publisherName → "addychang"
2 d ago · declared · homepageUrl → "https://miniurl.com/mcp/"
2 d ago · declared · repoUrl → "https://github.com/addychang/miniurl.com"
2 d ago · declared · version → "1.2.0"
2 d ago · declared · protocols → ["mcp"]

This record is unclaimed

Evidence

What the publisher says

Capabilities

Where this record came from