io.github.addychang/miniurl

MiniURL

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

1.2.0
Version
remote
Transport
23
Tools

Security review

Review passed

Reviewed Jan 1, 2000.

  • tools: 23 tools scanned
  • metadata: scanned

No findings.

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 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 idempotency_key when retrying the same logical request.

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