MiniURL
OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
| Endpoint | https://workers.miniurl.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.2.0 |
| Now | 23 tools · grade C (70) · pin ts_4ce4b8c16e1b673882232c22a3fcff7c · protocol 2025-06-18 |
| First / last listed | 2026-10-27 08:08 UTC / 2026-10-27 08:08 UTC |
| Grade over time | 2026-10-27: C (70), 23 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: create_guest_token clear_authentication shorten_url send_registration_code verify_registration_code get_account_status start_pro_upgrade list_domains add_domain delete_domain verify_domain list_links get_link update_link delete_link bulk_create_links get_link_stats check_alias list_tags create_tag delete_tag tag_link untag_link
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. params: none |
clear_authentication | Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests. params: none |
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. params: url*, alias, domain, password, expiration, activated_at, dry_run, idempotency_key |
send_registration_code | Send a 6-digit registration code to the user email, using the current guest session. params: email* |
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. params: email*, code* |
get_account_status | Inspect the current guest/free/pro account status, remaining quota, and feature availability. params: none |
start_pro_upgrade | Create a shortened checkout link for upgrading the current registered account to Pro. params: interval, idempotency_key, approval_id, approval_token |
list_domains | List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records. params: none |
add_domain | Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default. params: domain*, approval_id, approval_token |
delete_domain | Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default. params: domain_id*, confirm, approval_id, approval_token |
verify_domain | Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default. params: domain_id*, migrate_to_server, approval_id, approval_token |
list_links | List short links for the current registered account. params: limit, offset, cursor, search, domain |
get_link | Get a single short link by alias for the current registered account. params: alias*, domain |
update_link | Update a registered short link. Some fields require Pro. params: alias*, domain, url, password, clear_password, expiration, clear_expiration, activated_at, clear_activated_at, dry_run, idempotency_key |
delete_link | Delete a registered short link permanently. params: alias*, domain, dry_run, idempotency_key, approval_id, approval_token |
bulk_create_links | Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50. params: links*, idempotency_key |
get_link_stats | Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns. params: alias*, domain, period |
check_alias | Check whether a custom alias is available on a given domain before creating a link. params: alias*, domain |
list_tags | List all tags for the current registered account. Tags help organise links into campaigns or categories. params: none |
create_tag | Create a new tag for organising links. Maximum 20 tags per account. params: name*, color |
delete_tag | Delete a tag and remove it from all associated links. params: tag_id*, approval_id, approval_token |
tag_link | Add a tag to a short link for campaign or category organisation. params: alias*, domain, tag_id* |
untag_link | Remove a tag from a short link. params: alias*, domain, tag_id* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.