MiniURL is an MCP server published by io.github.addychang, hosted at workers.miniurl.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 23 tools, including create_guest_token, clear_authentication, shorten_url, send_registration_code, verify_registration_code.
OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
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 parameters.
{
"name": "create_guest_token",
"title": "MiniURL create_guest_token",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"expires_at": {
"type": "string"
},
"guest_token": {
"type": "string"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
No parameters.
{
"name": "clear_authentication",
"title": "MiniURL clear_authentication",
"description": "Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"auth_mode": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| url * | string | The HTTP or HTTPS destination URL to shorten. |
| alias | string | Optional custom alias. Call check_alias before creating it. Requires a registered account; miniurl.com aliases must be at least 4 characters. |
| domain | string | Optional domain. Requires a registered account with an active custom domain. |
| dry_run | boolean | Validate the destination and show the planned link without creating it. Agent tokens only. |
| password | string | Optional password. Requires Pro. |
| expiration | string | Optional ISO 8601 expiration datetime. Requires Pro. |
| activated_at | string | Optional ISO 8601 activation datetime. Requires Pro. |
| idempotency_key | string | Optional idempotency key. Reusing it with the same payload safely replays the original result. |
{
"name": "shorten_url",
"title": "MiniURL shorten_url",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "The HTTP or HTTPS destination URL to shorten."
},
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Optional custom alias. Call check_alias before creating it. Requires a registered account; miniurl.com aliases must be at least 4 characters."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "Optional domain. Requires a registered account with an active custom domain."
},
"dry_run": {
"type": "boolean",
"description": "Validate the destination and show the planned link without creating it. Agent tokens only."
},
"password": {
"type": "string",
"description": "Optional password. Requires Pro."
},
"expiration": {
"type": "string",
"format": "date-time",
"description": "Optional ISO 8601 expiration datetime. Requires Pro."
},
"activated_at": {
"type": "string",
"format": "date-time",
"description": "Optional ISO 8601 activation datetime. Requires Pro."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"maxLength": 128,
"minLength": 8,
"description": "Optional idempotency key. Reusing it with the same payload safely replays the original result."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"alias": {
"type": "string"
},
"domain": {
"type": "string"
},
"full_url": {
"type": "string"
},
"short_url": {
"type": "string"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Send a 6-digit registration code to the user email, using the current guest session.
| Parameter | Type | Description |
|---|---|---|
| email * | string | The user email address. |
{
"name": "send_registration_code",
"title": "MiniURL send_registration_code",
"description": "Send a 6-digit registration code to the user email, using the current guest session.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "The user email address."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| code * | string | The 6-digit verification code. |
| email * | string | The user email address. |
{
"name": "verify_registration_code",
"title": "MiniURL verify_registration_code",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"email",
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^\\d{6}$",
"description": "The 6-digit verification code."
},
"email": {
"type": "string",
"format": "email",
"description": "The user email address."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Inspect the current guest/free/pro account status, remaining quota, and feature availability.
No parameters.
{
"name": "get_account_status",
"title": "MiniURL get_account_status",
"description": "Inspect the current guest/free/pro account status, remaining quota, and feature availability.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a shortened checkout link for upgrading the current registered account to Pro.
| Parameter | Type | Description |
|---|---|---|
| interval | string | Billing interval. Defaults to monthly. |
| approval_id | string | Approval id returned by a previous USER_APPROVAL_REQUIRED response. |
| approval_token | string | Legacy compatibility field; normally omit it and retry with approval_id after approval. |
| idempotency_key | string |
{
"name": "start_pro_upgrade",
"title": "MiniURL start_pro_upgrade",
"description": "Create a shortened checkout link for upgrading the current registered account to Pro.",
"inputSchema": {
"type": "object",
"properties": {
"interval": {
"enum": [
"monthly",
"yearly"
],
"type": "string",
"description": "Billing interval. Defaults to monthly."
},
"approval_id": {
"type": "string",
"description": "Approval id returned by a previous USER_APPROVAL_REQUIRED response."
},
"approval_token": {
"type": "string",
"description": "Legacy compatibility field; normally omit it and retry with approval_id after approval."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"maxLength": 128,
"minLength": 8
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"interval": {
"type": "string"
},
"checkout_url": {
"type": "string"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.
No parameters.
{
"name": "list_domains",
"title": "MiniURL list_domains",
"description": "List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"domains": {
"type": "array"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | An 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. |
| approval_id | string | |
| approval_token | string | Legacy compatibility field; normally omit it. |
{
"name": "add_domain",
"title": "MiniURL add_domain",
"description": "Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"format": "hostname",
"description": "An 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."
},
"approval_id": {
"type": "string"
},
"approval_token": {
"type": "string",
"description": "Legacy compatibility field; normally omit it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | Set true only after reviewing the dry-run impact response. |
| domain_id * | integer | |
| approval_id | string | |
| approval_token | string | Legacy compatibility field; normally omit it. |
{
"name": "delete_domain",
"title": "MiniURL delete_domain",
"description": "Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.",
"inputSchema": {
"type": "object",
"required": [
"domain_id"
],
"properties": {
"confirm": {
"type": "boolean",
"description": "Set true only after reviewing the dry-run impact response."
},
"domain_id": {
"type": "integer",
"minimum": 1
},
"approval_id": {
"type": "string"
},
"approval_token": {
"type": "string",
"description": "Legacy compatibility field; normally omit it."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
| Parameter | Type | Description |
|---|---|---|
| domain_id * | integer | |
| approval_id | string | |
| approval_token | string | Legacy compatibility field; normally omit it. |
| migrate_to_server | boolean | 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. |
{
"name": "verify_domain",
"title": "MiniURL verify_domain",
"description": "Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.",
"inputSchema": {
"type": "object",
"required": [
"domain_id"
],
"properties": {
"domain_id": {
"type": "integer",
"minimum": 1
},
"approval_id": {
"type": "string"
},
"approval_token": {
"type": "string",
"description": "Legacy compatibility field; normally omit it."
},
"migrate_to_server": {
"type": "boolean",
"description": "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."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}List short links for the current registered account.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Optional page size. Defaults to 20. |
| cursor | string | Opaque cursor returned as next_cursor. Prefer cursor pagination for stable traversal. |
| domain | string | Optional domain filter. |
| offset | integer | Optional zero-based offset for pagination. Defaults to 0. |
| search | string | Optional search term for alias or destination URL. |
{
"name": "list_links",
"title": "MiniURL list_links",
"description": "List short links for the current registered account.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Optional page size. Defaults to 20."
},
"cursor": {
"type": "string",
"description": "Opaque cursor returned as next_cursor. Prefer cursor pagination for stable traversal."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "Optional domain filter."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Optional zero-based offset for pagination. Defaults to 0."
},
"search": {
"type": "string",
"description": "Optional search term for alias or destination URL."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"links": {
"type": "array"
},
"pagination": {
"type": "object"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get a single short link by alias for the current registered account.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | The link alias to fetch. |
| domain | string | The link domain. Defaults to miniurl.com. |
{
"name": "get_link",
"title": "MiniURL get_link",
"description": "Get a single short link by alias for the current registered account.",
"inputSchema": {
"type": "object",
"required": [
"alias"
],
"properties": {
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The link alias to fetch."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "The link domain. Defaults to miniurl.com."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Update a registered short link. Some fields require Pro.
| Parameter | Type | Description |
|---|---|---|
| url | string | New HTTP or HTTPS destination URL. Requires Pro. |
| alias * | string | The link alias to update. |
| domain | string | The link domain. Defaults to miniurl.com. |
| dry_run | boolean | Validate and preview the update without changing the link. Agent tokens only. |
| password | string | Set or replace the password. Requires Pro. |
| expiration | string | Set a new ISO 8601 expiration datetime. Requires Pro. |
| activated_at | string | Set a new ISO 8601 activation datetime. Requires Pro. |
| clear_password | boolean | Remove the current password. |
| idempotency_key | string | |
| clear_expiration | boolean | Clear the current expiration. |
| clear_activated_at | boolean | Clear the current scheduled activation datetime. |
{
"name": "update_link",
"title": "MiniURL update_link",
"description": "Update a registered short link. Some fields require Pro.",
"inputSchema": {
"type": "object",
"required": [
"alias"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "New HTTP or HTTPS destination URL. Requires Pro."
},
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The link alias to update."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "The link domain. Defaults to miniurl.com."
},
"dry_run": {
"type": "boolean",
"description": "Validate and preview the update without changing the link. Agent tokens only."
},
"password": {
"type": "string",
"description": "Set or replace the password. Requires Pro."
},
"expiration": {
"type": "string",
"format": "date-time",
"description": "Set a new ISO 8601 expiration datetime. Requires Pro."
},
"activated_at": {
"type": "string",
"format": "date-time",
"description": "Set a new ISO 8601 activation datetime. Requires Pro."
},
"clear_password": {
"type": "boolean",
"description": "Remove the current password."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"maxLength": 128,
"minLength": 8
},
"clear_expiration": {
"type": "boolean",
"description": "Clear the current expiration."
},
"clear_activated_at": {
"type": "boolean",
"description": "Clear the current scheduled activation datetime."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a registered short link permanently.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | The alias to delete. |
| domain | string | The link domain. Defaults to miniurl.com. |
| dry_run | boolean | Preview the deletion and affected link scope without writing. Human approval is still required for the real delete. |
| approval_id | string | Approval id returned by a previous USER_APPROVAL_REQUIRED response. |
| approval_token | string | Legacy compatibility field; normally omit it and retry with approval_id after approval. |
| idempotency_key | string |
{
"name": "delete_link",
"title": "MiniURL delete_link",
"description": "Delete a registered short link permanently.",
"inputSchema": {
"type": "object",
"required": [
"alias"
],
"properties": {
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The alias to delete."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "The link domain. Defaults to miniurl.com."
},
"dry_run": {
"type": "boolean",
"description": "Preview the deletion and affected link scope without writing. Human approval is still required for the real delete."
},
"approval_id": {
"type": "string",
"description": "Approval id returned by a previous USER_APPROVAL_REQUIRED response."
},
"approval_token": {
"type": "string",
"description": "Legacy compatibility field; normally omit it and retry with approval_id after approval."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"maxLength": 128,
"minLength": 8
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
| Parameter | Type | Description |
|---|---|---|
| links * | array | |
| idempotency_key | string |
{
"name": "bulk_create_links",
"title": "MiniURL bulk_create_links",
"description": "Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.",
"inputSchema": {
"type": "object",
"required": [
"links"
],
"properties": {
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"domain": {
"type": "string",
"format": "hostname"
},
"password": {
"type": "string"
},
"expiration": {
"type": "string",
"format": "date-time"
},
"activated_at": {
"type": "string",
"format": "date-time"
}
}
},
"maxItems": 50,
"minItems": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"maxLength": 128,
"minLength": 8
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"results": {
"type": "array"
},
"summary": {
"type": "object"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | The alias to inspect. |
| domain | string | Optional domain to scope the alias lookup. Defaults to miniurl.com. |
| period | string | Analytics time range. Defaults to 7D. |
{
"name": "get_link_stats",
"title": "MiniURL get_link_stats",
"description": "Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.",
"inputSchema": {
"type": "object",
"required": [
"alias"
],
"properties": {
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The alias to inspect."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "Optional domain to scope the alias lookup. Defaults to miniurl.com."
},
"period": {
"enum": [
"24H",
"7D",
"30D",
"ALL"
],
"type": "string",
"description": "Analytics time range. Defaults to 7D."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"clicks": {
"type": "array"
},
"total_clicks": {
"type": "integer"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check whether a custom alias is available on a given domain before creating a link.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | The alias to check. |
| domain | string | The domain to check on. Defaults to miniurl.com. |
{
"name": "check_alias",
"title": "MiniURL check_alias",
"description": "Check whether a custom alias is available on a given domain before creating a link.",
"inputSchema": {
"type": "object",
"required": [
"alias"
],
"properties": {
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The alias to check."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "The domain to check on. Defaults to miniurl.com."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"alias": {
"type": "string"
},
"exists": {
"type": "boolean"
},
"available": {
"type": "boolean"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List all tags for the current registered account. Tags help organise links into campaigns or categories.
No parameters.
{
"name": "list_tags",
"title": "MiniURL list_tags",
"description": "List all tags for the current registered account. Tags help organise links into campaigns or categories.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": "object",
"properties": {
"tags": {
"type": "array"
}
},
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a new tag for organising links. Maximum 20 tags per account.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Tag name, 1-30 characters. |
| color | string | Tag colour hex code. Defaults to #6b7280 (grey). |
{
"name": "create_tag",
"title": "MiniURL create_tag",
"description": "Create a new tag for organising links. Maximum 20 tags per account.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Tag name, 1-30 characters."
},
"color": {
"enum": [
"#6b7280",
"#ef4444",
"#f97316",
"#eab308",
"#22c55e",
"#06b6d4",
"#3b82f6",
"#8b5cf6",
"#ec4899"
],
"type": "string",
"description": "Tag colour hex code. Defaults to #6b7280 (grey)."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Delete a tag and remove it from all associated links.
| Parameter | Type | Description |
|---|---|---|
| tag_id * | integer | The tag ID to delete. |
| approval_id | string | Approval id returned by a previous USER_APPROVAL_REQUIRED response. |
| approval_token | string | Legacy compatibility field; normally omit it and retry with approval_id after approval. |
{
"name": "delete_tag",
"title": "MiniURL delete_tag",
"description": "Delete a tag and remove it from all associated links.",
"inputSchema": {
"type": "object",
"required": [
"tag_id"
],
"properties": {
"tag_id": {
"type": "integer",
"minimum": 1,
"description": "The tag ID to delete."
},
"approval_id": {
"type": "string",
"description": "Approval id returned by a previous USER_APPROVAL_REQUIRED response."
},
"approval_token": {
"type": "string",
"description": "Legacy compatibility field; normally omit it and retry with approval_id after approval."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Add a tag to a short link for campaign or category organisation.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | The link alias to tag. |
| domain | string | The link domain. Defaults to miniurl.com. |
| tag_id * | integer | The tag ID to assign. |
{
"name": "tag_link",
"title": "MiniURL tag_link",
"description": "Add a tag to a short link for campaign or category organisation.",
"inputSchema": {
"type": "object",
"required": [
"alias",
"tag_id"
],
"properties": {
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The link alias to tag."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "The link domain. Defaults to miniurl.com."
},
"tag_id": {
"type": "integer",
"minimum": 1,
"description": "The tag ID to assign."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Remove a tag from a short link.
| Parameter | Type | Description |
|---|---|---|
| alias * | string | The link alias. |
| domain | string | The link domain. Defaults to miniurl.com. |
| tag_id * | integer | The tag ID to remove. |
{
"name": "untag_link",
"title": "MiniURL untag_link",
"description": "Remove a tag from a short link.",
"inputSchema": {
"type": "object",
"required": [
"alias",
"tag_id"
],
"properties": {
"alias": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The link alias."
},
"domain": {
"type": "string",
"format": "hostname",
"description": "The link domain. Defaults to miniurl.com."
},
"tag_id": {
"type": "integer",
"minimum": 1,
"description": "The tag ID to remove."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"success",
"request_id"
],
"properties": {
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
],
"additionalProperties": true
},
"meta": {
"type": "object",
"additionalProperties": true
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": true
}
]
},
"success": {
"type": "boolean"
},
"approval": {
"type": "object",
"additionalProperties": true
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"minLength": 8
},
"retry_after": {
"type": "integer",
"minimum": 0
},
"next_actions": {
"type": "array",
"items": {
"type": "string"
}
},
"required_scope": {
"type": "string"
},
"user_action_required": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Use OAuth 2.1 with PKCE for production Agent access. Include the resource parameter for the MCP server, use the negotiated MCP-Protocol-Version header on every subsequent request, and request only the scopes needed. Guest shortening remains available for low-risk anonymous creation; long-lived API keys are not accepted by the production MCP endpoint.
Names, descriptions and schemas were written by the server and are shown as data.