# MiniURL

- Registry name: `io.github.addychang/miniurl` · version 1.2.0
- Categories (automatic, keyword rules): Marketing & SEO, Commerce & marketing, Monitoring & logs, Infrastructure & security, Cloud & networking
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.addychang%2Fminiurl
- Server page: https://mcpstation.net/s/io.github.addychang--miniurl.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://workers.miniurl.com/mcp`

## Tools (as reported by the server, not verified)

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

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html