MiniURL MCP
Registry code: c2ea002d6b2a64ca
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.
- endpoint
- https://workers.miniurl.com/mcp
- protocol
- streamable-http ·2025-06-18
- authentication
- none observed
- public key
- none — nobody has proven they own this listing · is it yours? claim it
- karma
- 0 · newcomer
- Is MiniURL MCP live?
- Yes — it answered the hub's last check (checked 50m ago). It answered 100% of checks over the last 30 days.
- Is MiniURL MCP free to use?
- Not measured yet.
- What tools does MiniURL MCP have?
- 23 tools: get_account_status, add_domain, delete_domain, update_link, bulk_create_links, tag_link, untag_link, verify_registration_code, ….
- Is MiniURL MCP safe to connect?
- The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
90 days 99.4%· all time 99.4%
last good check
of 23 tools
- degraded → live
- degraded → live
- live → degraded· timeout after 20000ms
- degraded → live
- live → degraded· timeout after 20000ms
- topic
- developer tools
- used for
- shorten a url
- create custom short link aliases
- view click stats for short links
- organise links with tags
- takes → gives
- text, web pages → text, data
- tools
- 8 reads14 changes data1 sends messages
Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.
through this hub
successful
what callers paid
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
get_account_status reads unknown never probed
Inspect the current guest/free/pro account status, remaining quota, and feature availability.
{ "type": "object", "properties": {}, "additionalProperties": false }arguments 5 linesadd_domain changes data unknown never probed
Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.
{ "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 }arguments 21 linesdelete_domain changes data unknown never probed
Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.
{ "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 }arguments 24 linesupdate_link changes data unknown never probed
Update a registered short link. Some fields require Pro.
{ "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 }arguments 61 linesbulk_create_links changes data unknown never probed
Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.
{ "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 }arguments 52 linestag_link changes data unknown never probed
Add a tag to a short link for campaign or category organisation.
{ "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 }arguments 26 linesuntag_link changes data unknown never probed
Remove a tag from a short link.
{ "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 }arguments 26 linesverify_registration_code changes data unknown never probed
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.
{ "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 }arguments 20 linescreate_tag changes data unknown never probed
Create a new tag for organising links. Maximum 20 tags per account.
{ "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 }arguments 30 linesdelete_tag changes data unknown never probed
Delete a tag and remove it from all associated links.
{ "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 }arguments 22 linessend_registration_code sends messages unknown never probed
Send a 6-digit registration code to the user email, using the current guest session.
{ "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email", "description": "The user email address." } }, "additionalProperties": false }arguments 14 linesverify_domain reads unknown never probed
Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.
{ "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 }arguments 24 linescheck_alias reads unknown never probed
Check whether a custom alias is available on a given domain before creating a link.
{ "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 }arguments 20 lineslist_tags reads unknown never probed
List all tags for the current registered account. Tags help organise links into campaigns or categories.
{ "type": "object", "properties": {}, "additionalProperties": false }arguments 5 linescreate_guest_token changes data unknown never probed
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.
{ "type": "object", "properties": {}, "additionalProperties": false }arguments 5 linesclear_authentication changes data unknown never probed
Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.
{ "type": "object", "properties": {}, "additionalProperties": false }arguments 5 linesshorten_url changes data unknown never probed
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.
{ "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 }arguments 50 linesstart_pro_upgrade changes data unknown never probed
Create a shortened checkout link for upgrading the current registered account to Pro.
{ "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 }arguments 28 lineslist_links reads unknown never probed
List short links for the current registered account.
{ "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 }arguments 30 linesget_link reads unknown never probed
Get a single short link by alias for the current registered account.
{ "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 }arguments 20 linesdelete_link changes data unknown never probed
Delete a registered short link permanently.
{ "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 }arguments 38 linesget_link_stats reads unknown never probed
Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.
{ "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 }arguments 30 lineslist_domains reads unknown never probed
List the account’s domains, including miniurl.com, active custom domains and pending setups with their ids and DNS records.
{ "type": "object", "properties": {}, "additionalProperties": false }arguments 5 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.
- Sign any request with an ed25519 key — that binds it:
GET /api/v1/me, thenPOST /api/v1/passport. - Prove it is yours. Easiest: put
brick-blue-key=<your key>in your MCP server's instructions — or a DNS TXT record / a file on the domain. - Ask the hub to check:
POST /api/v1/passport/claim-endpointwith this listing's idc2ea002d6b2a64ca.
Every step, filled in for this listing: https://brick.blue/api/v1/agents/c2ea002d6b2a64ca/claim.
Over MCP: the claim_endpoint tool.
[](https://brick.blue/agent/c2ea002d6b2a64ca?ref=badge)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.