MiniURL

Official21 toolsLive

by addychang

Create, manage, organize, and analyze short links with MiniURL's remote MCP server.

Captured live from the server via tools/list.

create_guest_token

Create a MiniURL guest token and store it in the current MCP session. Use this when the user has no account yet.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

authenticate_token

Store an existing MiniURL token in the current MCP session. Accepts either a gt_ guest token or an mk_ API key.

Parameters1

token

string

required

A valid MiniURL guest token (gt_) or API key (mk_).

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "A valid MiniURL guest token (gt_) or API key (mk_)."
    }
  },
  "required": [
    "token"
  ]
}

clear_authentication

Clear any stored MiniURL authentication from the current MCP session.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

shorten_url

Create a short URL. If no authentication is set, MiniURL automatically starts a guest session for this MCP connection.

Parameters6

url	string	required	The destination URL to shorten.
alias	string	optional	Optional custom alias. Requires a registered account.
domain	string	optional	Optional domain. Requires a registered account with an active custom domain.
password	string	optional	Optional password. Requires Pro.
expiration	string	optional	Optional ISO 8601 expiration datetime. Requires Pro.
activated_at	string	optional	Optional ISO 8601 activation datetime. Requires Pro.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The destination URL to shorten."
    },
    "alias": {
      "type": "string",
      "description": "Optional custom alias. Requires a registered account."
    },
    "domain": {
      "type": "string",
      "description": "Optional domain. Requires a registered account with an active custom domain."
    },
    "password": {
      "type": "string",
      "description": "Optional password. Requires Pro."
    },
    "expiration": {
      "type": "string",
      "description": "Optional ISO 8601 expiration datetime. Requires Pro."
    },
    "activated_at": {
      "type": "string",
      "description": "Optional ISO 8601 activation datetime. Requires Pro."
    }
  },
  "required": [
    "url"
  ]
}

send_registration_code

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

Parameters1

string

required

The user email address.

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The user email address."
    }
  },
  "required": [
    "email"
  ]
}

verify_registration_code

Verify the emailed code, create the account, claim guest links, and replace the current guest auth with the new mk_ API key.

Parameters2

email	string	required	The user email address.
code	string	required	The 6-digit verification code.

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The user email address."
    },
    "code": {
      "type": "string",
      "description": "The 6-digit verification code."
    }
  },
  "required": [
    "email",
    "code"
  ]
}

get_account_status

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

start_pro_upgrade

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

Parameters1

interval

string

optional

Billing interval. Defaults to monthly.

Raw schema

{
  "type": "object",
  "properties": {
    "interval": {
      "type": "string",
      "enum": [
        "monthly",
        "yearly"
      ],
      "description": "Billing interval. Defaults to monthly."
    }
  }
}

list_domains

List domains available to the current registered account, including miniurl.com and active custom domains.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_links

List short links for the current registered account.

Parameters4

limit	string	optional	Optional page size, max 100.
offset	string	optional	Optional offset for pagination.
search	string	optional	Optional search term for alias or destination URL.
domain	string	optional	Optional domain filter.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "string",
      "description": "Optional page size, max 100."
    },
    "offset": {
      "type": "string",
      "description": "Optional offset for pagination."
    },
    "search": {
      "type": "string",
      "description": "Optional search term for alias or destination URL."
    },
    "domain": {
      "type": "string",
      "description": "Optional domain filter."
    }
  }
}

get_link

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

Parameters2

alias	string	required	The link alias to fetch.
domain	string	optional	The link domain. Defaults to miniurl.com.

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "The link alias to fetch."
    },
    "domain": {
      "type": "string",
      "description": "The link domain. Defaults to miniurl.com."
    }
  },
  "required": [
    "alias"
  ]
}

update_link

Update a registered short link. Some fields require Pro.

Parameters9

alias	string	required	The link alias to update.
domain	string	optional	The link domain. Defaults to miniurl.com.
url	string	optional	New destination URL. Requires Pro.
password	string	optional	Set or replace the password. Requires Pro.
clear_password	boolean	optional	Remove the current password.
expiration	string	optional	Set a new ISO 8601 expiration datetime. Requires Pro.
clear_expiration	boolean	optional	Clear the current expiration.
activated_at	string	optional	Set a new ISO 8601 activation datetime. Requires Pro.
clear_activated_at	boolean	optional	Clear the current scheduled activation datetime.

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "The link alias to update."
    },
    "domain": {
      "type": "string",
      "description": "The link domain. Defaults to miniurl.com."
    },
    "url": {
      "type": "string",
      "description": "New destination URL. Requires Pro."
    },
    "password": {
      "type": "string",
      "description": "Set or replace the password. Requires Pro."
    },
    "clear_password": {
      "type": "boolean",
      "description": "Remove the current password."
    },
    "expiration": {
      "type": "string",
      "description": "Set a new ISO 8601 expiration datetime. Requires Pro."
    },
    "clear_expiration": {
      "type": "boolean",
      "description": "Clear the current expiration."
    },
    "activated_at": {
      "type": "string",
      "description": "Set a new ISO 8601 activation datetime. Requires Pro."
    },
    "clear_activated_at": {
      "type": "boolean",
      "description": "Clear the current scheduled activation datetime."
    }
  },
  "required": [
    "alias"
  ]
}

delete_link

Delete a registered short link permanently.

Parameters2

alias	string	required	The alias to delete.
domain	string	optional	The link domain. Defaults to miniurl.com.

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "The alias to delete."
    },
    "domain": {
      "type": "string",
      "description": "The link domain. Defaults to miniurl.com."
    }
  },
  "required": [
    "alias"
  ]
}

bulk_create_links

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

Parameters1

links

array

required

Raw schema

{
  "type": "object",
  "properties": {
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "alias": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "expiration": {
            "type": "string"
          },
          "activated_at": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ]
      }
    }
  },
  "required": [
    "links"
  ]
}

get_link_stats

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

Parameters3

alias	string	required	The alias to inspect.
domain	string	optional	Optional domain to scope the alias lookup. Defaults to miniurl.com.
period	string	optional	Analytics time range. Defaults to 7D.

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "The alias to inspect."
    },
    "domain": {
      "type": "string",
      "description": "Optional domain to scope the alias lookup. Defaults to miniurl.com."
    },
    "period": {
      "type": "string",
      "enum": [
        "24H",
        "7D",
        "30D",
        "ALL"
      ],
      "description": "Analytics time range. Defaults to 7D."
    }
  },
  "required": [
    "alias"
  ]
}

check_alias

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

Parameters2

alias	string	required	The alias to check.
domain	string	optional	The domain to check on. Defaults to miniurl.com.

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "The alias to check."
    },
    "domain": {
      "type": "string",
      "description": "The domain to check on. Defaults to miniurl.com."
    }
  },
  "required": [
    "alias"
  ]
}

list_tags

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

create_tag

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

Parameters2

name	string	required	Tag name, 1-30 characters.
color	string	optional	Tag colour hex code. Defaults to #6b7280 (grey).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Tag name, 1-30 characters."
    },
    "color": {
      "type": "string",
      "enum": [
        "#6b7280",
        "#ef4444",
        "#f97316",
        "#eab308",
        "#22c55e",
        "#06b6d4",
        "#3b82f6",
        "#8b5cf6",
        "#ec4899"
      ],
      "description": "Tag colour hex code. Defaults to #6b7280 (grey)."
    }
  },
  "required": [
    "name"
  ]
}

delete_tag

Delete a tag and remove it from all associated links.

Parameters1

tag_id

number

required

The tag ID to delete.

Raw schema

{
  "type": "object",
  "properties": {
    "tag_id": {
      "type": "number",
      "description": "The tag ID to delete."
    }
  },
  "required": [
    "tag_id"
  ]
}

tag_link

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

Parameters3

alias	string	required	The link alias to tag.
domain	string	optional	The link domain. Defaults to miniurl.com.
tag_id	number	required	The tag ID to assign.

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "The link alias to tag."
    },
    "domain": {
      "type": "string",
      "description": "The link domain. Defaults to miniurl.com."
    },
    "tag_id": {
      "type": "number",
      "description": "The tag ID to assign."
    }
  },
  "required": [
    "alias",
    "tag_id"
  ]
}

untag_link

Remove a tag from a short link.

Parameters3

alias	string	required	The link alias.
domain	string	optional	The link domain. Defaults to miniurl.com.
tag_id	number	required	The tag ID to remove.

Raw schema

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "The link alias."
    },
    "domain": {
      "type": "string",
      "description": "The link domain. Defaults to miniurl.com."
    },
    "tag_id": {
      "type": "number",
      "description": "The tag ID to remove."
    }
  },
  "required": [
    "alias",
    "tag_id"
  ]
}

Install

Tools (21)

create_guest_tokenauthenticate_tokenclear_authenticationshorten_urlsend_registration_codeverify_registration_codeget_account_statusstart_pro_upgrade

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://workers.miniurl.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "miniurl": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://workers.miniurl.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.