MiniURL

io.github.addychang/miniurlVersion 1.2.0

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

Status

Responds191 msNov 14, 2026, 14:44 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 14:44 UTC
Latency: 191 ms
Remotes responding: 1 of 1
Sign-in: No sign-in
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 21:12 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://workers.miniurl.com/mcpResponds191 msNov 14, 2026, 14:44 UTC

No sign-in

Claude Code

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

Claude Desktop and claude.ai

1
2
3

Settings > Connectors > Add custom connector
Name: miniurl
Remote MCP server URL: https://workers.miniurl.com/mcp

Cursor

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

VS Code

code --add-mcp '{"name":"miniurl","type":"http","url":"https://workers.miniurl.com/mcp"}'

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

23 tools

Tools of MiniURL
	Description		Read-only	Idempotent	Open world
`add_domain`Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.	Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.	Yes	No	No	No
`bulk_create_links`Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.	Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.	No	No	No	No
`check_alias`Check whether a custom alias is available on a given domain before creating a link.	Check whether a custom alias is available on a given domain before creating a link.	No	Yes	Yes	Yes
`clear_authentication`Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.	Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.	No	No	Yes	No
`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.	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.	No	No	No	No
`create_tag`Create a new tag for organising links. Maximum 20 tags per account.	Create a new tag for organising links. Maximum 20 tags per account.	No	No	No	No
`delete_domain`Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.	Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.	Yes	No	No	No
`delete_link`Delete a registered short link permanently.	Delete a registered short link permanently.	Yes	No	No	No
`delete_tag`Delete a tag and remove it from all associated links.	Delete a tag and remove it from all associated links.	Yes	No	No	No
`get_account_status`Inspect the current guest/free/pro account status, remaining quota, and feature availability.	Inspect the current guest/free/pro account status, remaining quota, and feature availability.	No	Yes	Yes	No
`get_link`Get a single short link by alias for the current registered account.	Get a single short link by alias for the current registered account.	No	Yes	Yes	No
`get_link_stats`Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.	Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.	No	Yes	Yes	No
`list_domains`List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.	List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.	No	Yes	Yes	No
`list_links`List short links for the current registered account.	List short links for the current registered account.	No	Yes	Yes	No
`list_tags`List all tags for the current registered account. Tags help organise links into campaigns or categories.	List all tags for the current registered account. Tags help organise links into campaigns or categories.	No	Yes	Yes	No
`send_registration_code`Send a 6-digit registration code to the user email, using the current guest session.	Send a 6-digit registration code to the user email, using the current guest session.	No	No	No	No
`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.	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.	No	No	No	Yes
`start_pro_upgrade`Create a shortened checkout link for upgrading the current registered account to Pro.	Create a shortened checkout link for upgrading the current registered account to Pro.	Yes	No	No	No
`tag_link`Add a tag to a short link for campaign or category organisation.	Add a tag to a short link for campaign or category organisation.	No	No	No	No
`untag_link`Remove a tag from a short link.	Remove a tag from a short link.	No	No	No	No
`update_link`Update a registered short link. Some fields require Pro.	Update a registered short link. Some fields require Pro.	No	No	No	No
`verify_domain`Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.	Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.	No	No	No	No
`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.	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.	No	No	No	No

Details

Registry status: Active
Published: Aug 8, 2026
Updated: Aug 8, 2026
Website: https://miniurl.com/mcp/⁠ (opens in a new tab)
Repository: https://github.com/addychang/miniurl.com⁠ (opens in a new tab)
Categories (suggested): SecuritySuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing