# MiniURL (remote · workers.miniurl.com)

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

- Trust score: 67/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `workers.miniurl.com`: 67/100 (this document), [markdown](https://verifymcp.io/servers/addychang-miniurl/workers.md), [page](https://verifymcp.io/servers/addychang-miniurl/workers)

## Channel facts

- Endpoint: `https://workers.miniurl.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.0`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (delete_link).
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1228 tokens (~58/item across 21 items; 21 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 99/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 98% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http addychang-miniurl https://workers.miniurl.com/mcp
```

### Codex

```toml
[mcp_servers.addychang-miniurl]
url = "https://workers.miniurl.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "addychang-miniurl": {
      "type": "remote",
      "url": "https://workers.miniurl.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add addychang-miniurl --url https://workers.miniurl.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  addychang-miniurl:
    url: "https://workers.miniurl.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "addychang-miniurl": {
      "type": "http",
      "url": "https://workers.miniurl.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 66, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 66, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 64, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 63)

First indexed and scored.

## MCP tools (21)

### `create_guest_token` (~49 tokens)

Create a MiniURL guest token and store it in an unauthenticated MCP session. If auth is already set, keep it or call clear_authentication first. shorten_url can provision a guest automatically.

### `authenticate_token` (~57 tokens)

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

Input parameters:

- `token` (string, required): A valid MiniURL guest token (gt_) or API key (mk_).

### `clear_authentication` (~21 tokens)

Clear any stored MiniURL authentication from the current MCP session.

### `shorten_url` (~139 tokens)

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

Input parameters:

- `activated_at` (string): Optional ISO 8601 activation datetime. Requires Pro.
- `alias` (string): Optional custom alias. 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.
- `expiration` (string): Optional ISO 8601 expiration datetime. Requires Pro.
- `password` (string): Optional password. Requires Pro.
- `url` (string, required): The HTTP or HTTPS destination URL to shorten.

### `send_registration_code` (~38 tokens)

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

Input parameters:

- `email` (string, required): The user email address.

### `verify_registration_code` (~60 tokens)

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

Input parameters:

- `code` (string, required): The 6-digit verification code.
- `email` (string, required): The user email address.

### `get_account_status` (~25 tokens)

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

### `start_pro_upgrade` (~36 tokens)

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

Input parameters:

- `interval` (string): Billing interval. Defaults to monthly.

### `list_domains` (~26 tokens)

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

### `list_links` (~75 tokens)

List short links for the current registered account.

Input parameters:

- `domain` (string): Optional domain filter.
- `limit` (integer): Optional page size. Defaults to 20.
- `offset` (integer): Optional zero-based offset for pagination. Defaults to 0.
- `search` (string): Optional search term for alias or destination URL.

### `get_link` (~49 tokens)

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

Input parameters:

- `alias` (string, required): The link alias to fetch.
- `domain` (string): The link domain. Defaults to miniurl.com.

### `update_link` (~158 tokens)

Update a registered short link. Some fields require Pro.

Input parameters:

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

### `delete_link` (~42 tokens)

Delete a registered short link permanently.

Input parameters:

- `alias` (string, required): The alias to delete.
- `domain` (string): The link domain. Defaults to miniurl.com.

### `bulk_create_links` (~42 tokens)

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

Input parameters:

- `links` (array, required)

### `get_link_stats` (~78 tokens)

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

Input parameters:

- `alias` (string, required): 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.

### `check_alias` (~53 tokens)

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

Input parameters:

- `alias` (string, required): The alias to check.
- `domain` (string): The domain to check on. Defaults to miniurl.com.

### `list_tags` (~26 tokens)

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

### `create_tag` (~59 tokens)

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

Input parameters:

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

### `delete_tag` (~32 tokens)

Delete a tag and remove it from all associated links.

Input parameters:

- `tag_id` (integer, required): The tag ID to delete.

### `tag_link` (~62 tokens)

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

Input parameters:

- `alias` (string, required): The link alias to tag.
- `domain` (string): The link domain. Defaults to miniurl.com.
- `tag_id` (integer, required): The tag ID to assign.

### `untag_link` (~56 tokens)

Remove a tag from a short link.

Input parameters:

- `alias` (string, required): The link alias.
- `domain` (string): The link domain. Defaults to miniurl.com.
- `tag_id` (integer, required): The tag ID to remove.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/addychang-miniurl/workers#diagnostics

## Score history

- 2026-08-03: 67
- 2026-08-02: 67
- 2026-08-01: 66
- 2026-07-31: 66
- 2026-07-30: 66
- 2026-07-29: 65
- 2026-07-28: 65
- 2026-07-27: 64
- 2026-07-26: 63

## Links

- Remote endpoint: https://workers.miniurl.com/mcp
- Repository: https://github.com/addychang/miniurl.com
- Website: https://miniurl.com/mcp/
- Changelog RSS feed: https://verifymcp.io/servers/addychang-miniurl/workers/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/addychang-miniurl/workers/changelog.json
- HTML version of this page: https://verifymcp.io/servers/addychang-miniurl/workers