Back to search
100
MCP live MCP 2026-07-28 streamable-http

MiniURL

io.github.addychang/miniurl

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

Uptime
100.0%
1 direct probes · 30d
Response
109ms
last probe
Tools
23
callable
Resources
0
readable
Prompts
0
available
Primary URL
https://workers.miniurl.com/mcp

Tools · 23

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. shorten_url can provision one automatic…

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 external write; do not fetch or open the d…

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.

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "miniurl": {
      "url": "https://workers.miniurl.com/mcp",
      "transport": "streamable-http"
    }
  }
}