io.github.addychangPublished by GitHub account addychangv1.2.0Updated Oct 24, 2026
OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
MiniURL gives an assistant OAuth 2.1 short-link tools with scoped tokens, approvals, audit logs, and revocation.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.addychang%2Fminiurl/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"miniurl": {
"type": "http",
"url": "https://workers.miniurl.com/mcp"
}
}
}This repository has no README.
MiniURL 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.
Takes no parameters.
MiniURL clear_authentication
Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
Takes no parameters.
MiniURL 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.
urlrequiredaliasdomaindry_runpasswordexpirationactivated_atidempotency_keyMiniURL send_registration_code
Send a 6-digit registration code to the user email, using the current guest session.
emailrequiredMiniURL 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.
coderequiredemailrequiredMiniURL get_account_status
Inspect the current guest/free/pro account status, remaining quota, and feature availability.
Takes no parameters.
MiniURL start_pro_upgrade
Create a shortened checkout link for upgrading the current registered account to Pro.
intervalapproval_idapproval_tokenidempotency_keyMiniURL list_domains
List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.
Takes no parameters.
MiniURL add_domain
Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
domainrequiredapproval_idapproval_tokenMiniURL delete_domain
Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
confirmdomain_idrequiredapproval_idapproval_tokenMiniURL verify_domain
Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
domain_idrequiredapproval_idapproval_tokenmigrate_to_serverMiniURL list_links
List short links for the current registered account.
limitcursordomainoffsetsearchMiniURL get_link
Get a single short link by alias for the current registered account.
aliasrequireddomainMiniURL update_link
Update a registered short link. Some fields require Pro.
urlaliasrequireddomaindry_runpasswordexpirationactivated_atclear_passwordidempotency_keyclear_expirationclear_activated_atMiniURL delete_link
Delete a registered short link permanently.
aliasrequireddomaindry_runapproval_idapproval_tokenidempotency_keyMiniURL bulk_create_links
Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
linksrequiredidempotency_keyMiniURL get_link_stats
Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
aliasrequireddomainperiodMiniURL check_alias
Check whether a custom alias is available on a given domain before creating a link.
aliasrequireddomainMiniURL list_tags
List all tags for the current registered account. Tags help organise links into campaigns or categories.
Takes no parameters.
MiniURL create_tag
Create a new tag for organising links. Maximum 20 tags per account.
namerequiredcolorMiniURL delete_tag
Delete a tag and remove it from all associated links.
tag_idrequiredapproval_idapproval_tokenMiniURL tag_link
Add a tag to a short link for campaign or category organisation.
aliasrequireddomaintag_idrequiredMiniURL untag_link
Remove a tag from a short link.
aliasrequireddomaintag_idrequired75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
Declare a license in the repository or the registry entry.