io.github.addychang/miniurl

up checked 2026-11-10T21:37:36.164Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

MiniURL

Publisher-provided description

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

Summary by lookupd

Creates and manages short links, tags, custom domains, and analytics via OAuth-scoped tokens, with human approval for domain changes.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add miniurl --url https://workers.miniurl.com/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (23 tools)

Publisher-provided text

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

Details

• Version: 1.2.0
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 1053 ms
• First indexed: 2026-11-01T09:19:05.922Z
• Last seen in registry: 2026-11-01T09:19:05.947Z
• Repository: https://github.com/addychang/miniurl.com
• Website: https://miniurl.com/mcp/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.addychang/miniurl.svg)](https://lookupd.com/servers/io.github.addychang/miniurl)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp