Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

MiniURL

REMOTE · WORKERS.MINIURL.COM

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

0 this week 78 Trust /100

Last scanned (21 hours ago)

Scores higher than 76% of remote servers

Reachable. Last reached 4 Nov 2026.

Category Workflow Automation

Recent critical change

Authorization (13 Oct 2026). See the changelog before you install this server.

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security57
Transport & Reachability100
Schema Quality & AI Usability76
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 1819 tokens (~79/item across 23 items; 23 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage96
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 85% of tool parameters carry a description.Partial
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 24 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 13 Oct 26 +41
    • Authorization: unverified → fail ▼ critical
    • Injection markers: unverified → pass ▲ security
    • Stability: unverified → pass ▲ security
    • Tool coverage: unverified → 100 ▲ functional
  • 12 Oct 26 −41
    • Stability: pass → unverified ▼ security
    • Authorization: fail → unverified ▼ security
    • Tool safety: pass → unverified ▼ security
    • Tool coverage: 100 → unverified ▼ functional
    • First check of Schema quality: unverified functional
    • This server's schema is too large to store in full, so we cannot compare its tools day to day functional
  • 28 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 25 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 7 Sept 26 0
    • Stability: fail → pass ▲ security
  • 26 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 11 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 9 Aug 26 0
    • The server rewrote its instructions, which are the text every model session reads security
    • Tool “clear_authentication” rewrote its description, which is the text the model reads security
    • Tool “create_guest_token” rewrote its description, which is the text the model reads security
    • Tool “shorten_url” rewrote its description, which is the text the model reads security
    • MCP protocol: Implements a current MCP spec version (2026-07-28). functional
    • MCP protocol version: 2025-11-25 → 2026-07-28 functional
    • Server version: 1.2.0 → 1.3.0 functional
    • “shorten_url” reworded the description of “alias” cosmetic
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Nov 2026 · Probed https://workers.miniurl.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=miniurl.com CN=YE1,O=Let's Encrypt,C=US 14 Sept 2026 13 Dec 2026 ECDSA 256 ECDSA-SHA384 51fd8c6c994a8cbef9a04e876b7faa1202d
SANs: miniurl.com, workers.miniurl.com
CN=YE1,O=Let's Encrypt,C=US (CA) CN=Root YE,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 ECDSA 384 ECDSA-SHA384 5ddd70dd31f801c85c186a7a04b80afe
CN=Root YE,O=ISRG,C=US (CA) CN=ISRG Root X2,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 ECDSA-SHA384 872165fc34b6e5fba8add5b3705fb53a
CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 SHA256-RSA 6c8f1dc727c7117f7baf853ac980f9cd

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of workers.miniurl.com. — Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
miniurl.com. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://workers.miniurl.com/mcp Verified 200
http (plaintext) http://workers.miniurl.com/mcp HTTPS enforced 301 https://workers.miniurl.com/mcp
MCP tools · 23 exposed · ~1,751 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
add_domain ~88

Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.

NameTypeReqDescription
approval_idstring––
approval_tokenstring–Legacy compatibility field; normally omit it.
domainstringyesAn apex domain such as example.com or subdomain such as links.example.com. New domains use A + ownership TXT records and automatic HTTPS on the server.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

bulk_create_links ~52

Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.

NameTypeReqDescription
idempotency_keystring––
linksarrayyes–
NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

check_alias ~53

Check whether a custom alias is available on a given domain before creating a link.

NameTypeReqDescription
aliasstringyesThe alias to check.
domainstring–The domain to check on. Defaults to miniurl.com.
NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

clear_authentication ~32

Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.

Input schema present but exposes no named parameters.

NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

create_guest_token ~47

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.

Input schema present but exposes no named parameters.

NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

create_tag ~59

Create a new tag for organising links. Maximum 20 tags per account.

NameTypeReqDescription
colorstring–Tag colour hex code. Defaults to #6b7280 (grey).
namestringyesTag name, 1-30 characters.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

delete_domain ~79

Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.

NameTypeReqDescription
approval_idstring––
approval_tokenstring–Legacy compatibility field; normally omit it.
confirmboolean–Set true only after reviewing the dry-run impact response.
domain_idintegeryes–
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

delete_link ~120

Delete a registered short link permanently.

NameTypeReqDescription
aliasstringyesThe alias to delete.
approval_idstring–Approval id returned by a previous USER_APPROVAL_REQUIRED response.
approval_tokenstring–Legacy compatibility field; normally omit it and retry with approval_id after approval.
domainstring–The link domain. Defaults to miniurl.com.
dry_runboolean–Preview the deletion and affected link scope without writing. Human approval is still required for the real delete.
idempotency_keystring––
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

delete_tag ~73

Delete a tag and remove it from all associated links.

NameTypeReqDescription
approval_idstring–Approval id returned by a previous USER_APPROVAL_REQUIRED response.
approval_tokenstring–Legacy compatibility field; normally omit it and retry with approval_id after approval.
tag_idintegeryesThe tag ID to delete.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

get_account_status ~25

Inspect the current guest/free/pro account status, remaining quota, and feature availability.

Input schema present but exposes no named parameters.

NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

get_link ~49

Get a single short link by alias for the current registered account.

NameTypeReqDescription
aliasstringyesThe link alias to fetch.
domainstring–The link domain. Defaults to miniurl.com.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

get_link_stats ~78

Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.

NameTypeReqDescription
aliasstringyesThe alias to inspect.
domainstring–Optional domain to scope the alias lookup. Defaults to miniurl.com.
periodstring–Analytics time range. Defaults to 7D.
NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

list_domains ~32

List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.

Input schema present but exposes no named parameters.

NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

list_links ~96

List short links for the current registered account.

NameTypeReqDescription
cursorstring–Opaque cursor returned as next_cursor. Prefer cursor pagination for stable traversal.
domainstring–Optional domain filter.
limitinteger–Optional page size. Defaults to 20.
offsetinteger–Optional zero-based offset for pagination. Defaults to 0.
searchstring–Optional search term for alias or destination URL.
NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

list_tags ~26

List all tags for the current registered account. Tags help organise links into campaigns or categories.

Input schema present but exposes no named parameters.

NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

send_registration_code ~38

Send a 6-digit registration code to the user email, using the current guest session.

NameTypeReqDescription
emailstringyesThe user email address.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

shorten_url ~248

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.

NameTypeReqDescription
activated_atstring–Optional ISO 8601 activation datetime. Requires Pro.
aliasstring–Optional custom alias. Call check_alias before creating it. Requires a registered account; miniurl.com aliases must be at least 4 characters.
domainstring–Optional domain. Requires a registered account with an active custom domain.
dry_runboolean–Validate the destination and show the planned link without creating it. Agent tokens only.
expirationstring–Optional ISO 8601 expiration datetime. Requires Pro.
idempotency_keystring–Optional idempotency key. Reusing it with the same payload safely replays the original result.
passwordstring–Optional password. Requires Pro.
urlstringyesThe HTTP or HTTPS destination URL to shorten.
NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

start_pro_upgrade ~87

Create a shortened checkout link for upgrading the current registered account to Pro.

NameTypeReqDescription
approval_idstring–Approval id returned by a previous USER_APPROVAL_REQUIRED response.
approval_tokenstring–Legacy compatibility field; normally omit it and retry with approval_id after approval.
idempotency_keystring––
intervalstring–Billing interval. Defaults to monthly.
NameTypeReqDescription
approvalobject––
dataobject––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

tag_link ~62

Add a tag to a short link for campaign or category organisation.

NameTypeReqDescription
aliasstringyesThe link alias to tag.
domainstring–The link domain. Defaults to miniurl.com.
tag_idintegeryesThe tag ID to assign.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

untag_link ~56

Remove a tag from a short link.

NameTypeReqDescription
aliasstringyesThe link alias.
domainstring–The link domain. Defaults to miniurl.com.
tag_idintegeryesThe tag ID to remove.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

update_link ~189

Update a registered short link. Some fields require Pro.

NameTypeReqDescription
activated_atstring–Set a new ISO 8601 activation datetime. Requires Pro.
aliasstringyesThe link alias to update.
clear_activated_atboolean–Clear the current scheduled activation datetime.
clear_expirationboolean–Clear the current expiration.
clear_passwordboolean–Remove the current password.
domainstring–The link domain. Defaults to miniurl.com.
dry_runboolean–Validate and preview the update without changing the link. Agent tokens only.
expirationstring–Set a new ISO 8601 expiration datetime. Requires Pro.
idempotency_keystring––
passwordstring–Set or replace the password. Requires Pro.
urlstring–New HTTP or HTTPS destination URL. Requires Pro.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

verify_domain ~94

Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.

NameTypeReqDescription
approval_idstring––
approval_tokenstring–Legacy compatibility field; normally omit it.
domain_idintegeryes–
migrate_to_serverboolean–Start migration of a legacy Cloudflare hostname to direct server DNS. Existing links remain available while A/TXT records and server HTTPS are being configured.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

verify_registration_code ~68

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.

NameTypeReqDescription
codestringyesThe 6-digit verification code.
emailstringyesThe user email address.
NameTypeReqDescription
approvalobject––
dataobject|array|string|number|boolean|null––
error–––
metaobject––
next_actionsarray––
request_idstringyes–
required_scopestring––
retry_afterinteger––
retryableboolean––
successbooleanyes–
user_action_requiredboolean––

No examples provided.

Install

How do I install the MiniURL MCP server?

MiniURL is a hosted endpoint at https://workers.miniurl.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · workers.miniurl.com

# add to Claude Code
claude mcp add --transport http addychang-miniurl 'https://workers.miniurl.com/mcp'
Common questions

What is the MiniURL MCP server?

MiniURL is an MCP server listed in the public MCP registry as io.github.addychang/miniurl. OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation. This page covers its hosted endpoint (https://workers.miniurl.com/mcp).

Is the MiniURL MCP server safe to use?

MiniURL scores 78 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the MiniURL MCP server expose?

MiniURL exposes 23 tools: create_guest_token, clear_authentication, shorten_url, send_registration_code, verify_registration_code, and 18 more. Their descriptions and schemas cost roughly 1,751 tokens of context every time the server is loaded.

Does the MiniURL MCP server require authentication?

No. We connected to MiniURL without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the MiniURL MCP server still maintained?

MiniURL is still listed as active in the MCP registry. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.