OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
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.
Legacy compatibility field; normally omit it.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
| Argument | 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. |
{
"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
}Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
| Argument | Type | Description |
|---|---|---|
| links* | array | |
| idempotency_key | string |
{
"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
}Check whether a custom alias is available on a given domain before creating a link.
| Argument | Type | Description |
|---|---|---|
| alias* | string | The alias to check. |
| domain | string | The domain to check on. Defaults to miniurl.com. |
{
"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
}Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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 arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Create a new tag for organising links. Maximum 20 tags per account.
| Argument | Type | Description |
|---|---|---|
| name* | string | Tag name, 1-30 characters. |
| color | string | Tag colour hex code. Defaults to #6b7280 (grey). |
{
"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
}Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
| Argument | 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. |
{
"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
}Delete a registered short link permanently.
| Argument | 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 |
{
"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
}Delete a tag and remove it from all associated links.
| Argument | 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. |
{
"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
}Inspect the current guest/free/pro account status, remaining quota, and feature availability.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Get a single short link by alias for the current registered account.
| Argument | Type | Description |
|---|---|---|
| alias* | string | The link alias to fetch. |
| domain | string | The link domain. Defaults to miniurl.com. |
{
"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
}Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
| Argument | 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. |
{
"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
}List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List short links for the current registered account.
| Argument | 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. |
{
"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
}List all tags for the current registered account. Tags help organise links into campaigns or categories.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Send a 6-digit registration code to the user email, using the current guest session.
| Argument | Type | Description |
|---|---|---|
| email* | string | The user email address. |
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "The user email address."
}
},
"additionalProperties": 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.
| Argument | 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. |
Create a shortened checkout link for upgrading the current registered account to Pro.
| Argument | 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 |
{
"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
}Add a tag to a short link for campaign or category organisation.
| Argument | 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. |
{
"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
}Remove a tag from a short link.
| Argument | Type | Description |
|---|---|---|
| alias* | string | The link alias. |
| domain | string | The link domain. Defaults to miniurl.com. |
| tag_id* | integer | The tag ID to remove. |
{
"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
}Update a registered short link. Some fields require Pro.
| Argument | 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. |
Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
| Argument | 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. |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| code* | string | The 6-digit verification code. |
| email* | string | The user email address. |
{
"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
}{
"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
}| clear_activated_at | boolean | Clear the current scheduled activation datetime. |
{
"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
}