Connect-MCP

MiniURL

io.github.addychang/miniurl · v1.2.0

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

MCPremoteno credentialsCloud & DevOps

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 23 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 85/100

What it does: 23 tools · 7 read, 16 write (incl. delete/pay)

Test call list_domains: needs a key: HTTP 401 (979 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +7
  • Read/write annotations: +5
  • Safe test call: +8
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://workers.miniurl.com/mcp

Tools

23 tools listed at last check
  • 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 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.

Badge

Connect-MCP badge for io.github.addychang/miniurl

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.github.addychang/miniurl.svg)](https://clawy.uk/mcp/s/io.github.addychang/miniurl)

Repository · Website