All servers · Marketing & SEO · Monitoring & logs · Cloud & networking

MiniURL

io.github.addychang/miniurl · v1.2.0

Measured by MCP Station

Description written by the publisher, not verified

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

Connect

claude mcp add --transport http miniurl https://workers.miniurl.com/mcp

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

Tools as reported by the server

• 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 guest flow. Reuse idemp
• 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 write/delete
  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 write/delete
  Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
• delete_domain write/delete
  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 write/delete
  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 write/delete
  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.

Repository · Website · JSON · Text for agents · Registry updated 2026-08-08