Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

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

[mcp_servers.miniurl]
url = "https://workers.miniurl.com/mcp"

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

{
  "mcpServers": {
    "miniurl": {
      "type": "http",
      "url": "https://workers.miniurl.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=miniurl&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vd29ya2Vycy5taW5pdXJsLmNvbS9tY3AifQ%3D%3D"
}

{
  "servers": {
    "miniurl": {
      "type": "http",
      "url": "https://workers.miniurl.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "miniurl": {
      "httpUrl": "https://workers.miniurl.com/mcp"
    }
  }
}

extensions:
  "miniurl":
    enabled: true
    name: "miniurl"
    type: streamable_http
    uri: "https://workers.miniurl.com/mcp"
    timeout: 300

Quality 89 / 100good

protocol100 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
pass
protocol.list_ttltool list is cacheable (ttlMs 300000)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene100 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations23 of 23 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 3,555 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability50 · weight 15

pass
stability.changes3 tool changes in 30 days
fail
stability.rug_pull1 tools kept their name but changed most of their description in 30 days; review before trusting them

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

23 tools, about 3,555 tokens to load them all · tool set 820a09853f73 · tools last changed 2026-10-08 · checked 2026-10-19 10:20 UTC

Tool changes

2026-10-08verify_domainchangedinput schema
2026-10-08add_domainchangedinput schema
2026-10-08list_domainschangeddescriptionmeaning changed
before
List domains available to the current registered account, including miniurl.com and active custom domains.
after · 46% of words in common
List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90

liveness99

freshness85

hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-97% ~updated-72d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://workers.miniurl.com/mcp` streamable-http	none	yes	97%	268 ms	2026-07-28	2026-10-19

Tools (23)

`add_domain`destructive	Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
`bulk_create_links`	Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
`check_alias`read-only	Check whether a custom alias is available on a given domain before creating a link.
`clear_authentication`	Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
`create_guest_token`	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.
`create_tag`	Create a new tag for organising links. Maximum 20 tags per account.
`delete_domain`destructive	Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
`delete_link`destructive	Delete a registered short link permanently.
`delete_tag`destructive	Delete a tag and remove it from all associated links.
`get_account_status`read-only	Inspect the current guest/free/pro account status, remaining quota, and feature availability.
`get_link`read-only	Get a single short link by alias for the current registered account.
`get_link_stats`read-only	Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
`list_domains`read-only	List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.
`list_links`read-only	List short links for the current registered account.
`list_tags`read-only	List all tags for the current registered account. Tags help organise links into campaigns or categories.
`send_registration_code`	Send a 6-digit registration code to the user email, using the current guest session.
`shorten_url`	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.
`start_pro_upgrade`destructive	Create a shortened checkout link for upgrading the current registered account to Pro.
`tag_link`	Add a tag to a short link for campaign or category organisation.
`untag_link`	Remove a tag from a short link.
`update_link`	Update a registered short link. Some fields require Pro.
`verify_domain`	Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
`verify_registration_code`	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.addychang/miniurl",
  "title": "MiniURL",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://workers.miniurl.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.2.0",
  "repository": {
    "url": "https://github.com/addychang/miniurl.com",
    "source": "github"
  },
  "websiteUrl": "https://miniurl.com/mcp/",
  "description": "OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation."
}