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