MiniURL

Last 30 days

Uptime

100%

Response time

289 ms typical, 289 ms slowest 5%

Last check

4 h ago

Next check

in 3 h

How to call it

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "miniurl": {
      "type": "http",
      "url": "https://workers.miniurl.com/mcp"
    }
  }
}

23 tools

• 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 automatically.

• 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 destination. If no authentication is supplied, MiniURL automatically starts a gue

• 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 the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.

• 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.

Security scan

• No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks