Server definition
- Hash
- sha256:8be925831c29cb87bfbc2c72a38e1c21133a381bad28b4f268ac649611f03eb4
- What it is
- What a remote MCP server returned when asked what it offers: 23 tools
The blob, as servednamed by its sha256
{
"instructions": "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.",
"tools": [
{
"description": "Request a custom domain to be connected to MiniURL. Agent domain changes require human approval by default.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"approval_id": {
"type": "string"
},
"approval_token": {
"description": "Legacy compatibility field; normally omit it.",
"type": "string"
},
"domain": {
"description": "A custom hostname such as links.example.com.",
"format": "hostname",
"type": "string"
}
},
"required": [
"domain"
],
"type": "object"
},
"name": "add_domain",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Create multiple short links in one request. Free accounts can create up to 10 at a time, Pro up to 50.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"idempotency_key": {
"maxLength": 128,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"type": "string"
},
"links": {
"items": {
"properties": {
"activated_at": {
"format": "date-time",
"type": "string"
},
"alias": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"domain": {
"format": "hostname",
"type": "string"
},
"expiration": {
"format": "date-time",
"type": "string"
},
"password": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
}
},
"required": [
"links"
],
"type": "object"
},
"name": "bulk_create_links",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"results": {
"type": "array"
},
"summary": {
"type": "object"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Check whether a custom alias is available on a given domain before creating a link.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "The alias to check.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "The domain to check on. Defaults to miniurl.com.",
"format": "hostname",
"type": "string"
}
},
"required": [
"alias"
],
"type": "object"
},
"name": "check_alias",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"alias": {
"type": "string"
},
"available": {
"type": "boolean"
},
"exists": {
"type": "boolean"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Clear authentication retained by a legacy MCP session. Stateless clients clear authentication by omitting the Authorization header on later requests.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "clear_authentication",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": false,
"properties": {
"auth_mode": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "create_guest_token",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"expires_at": {
"type": "string"
},
"guest_token": {
"type": "string"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Create a new tag for organising links. Maximum 20 tags per account.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"color": {
"description": "Tag colour hex code. Defaults to #6b7280 (grey).",
"enum": [
"#6b7280",
"#ef4444",
"#f97316",
"#eab308",
"#22c55e",
"#06b6d4",
"#3b82f6",
"#8b5cf6",
"#ec4899"
],
"type": "string"
},
"name": {
"description": "Tag name, 1-30 characters.",
"maxLength": 30,
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_tag",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Delete a custom domain and its linked URLs after a dry-run confirmation. Agent domain changes require human approval by default.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"approval_id": {
"type": "string"
},
"approval_token": {
"description": "Legacy compatibility field; normally omit it.",
"type": "string"
},
"confirm": {
"description": "Set true only after reviewing the dry-run impact response.",
"type": "boolean"
},
"domain_id": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"domain_id"
],
"type": "object"
},
"name": "delete_domain",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Delete a registered short link permanently.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "The alias to delete.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"approval_id": {
"description": "Approval id returned by a previous USER_APPROVAL_REQUIRED response.",
"type": "string"
},
"approval_token": {
"description": "Legacy compatibility field; normally omit it and retry with approval_id after approval.",
"type": "string"
},
"domain": {
"description": "The link domain. Defaults to miniurl.com.",
"format": "hostname",
"type": "string"
},
"dry_run": {
"description": "Preview the deletion and affected link scope without writing. Human approval is still required for the real delete.",
"type": "boolean"
},
"idempotency_key": {
"maxLength": 128,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"type": "string"
}
},
"required": [
"alias"
],
"type": "object"
},
"name": "delete_link",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Delete a tag and remove it from all associated links.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"approval_id": {
"description": "Approval id returned by a previous USER_APPROVAL_REQUIRED response.",
"type": "string"
},
"approval_token": {
"description": "Legacy compatibility field; normally omit it and retry with approval_id after approval.",
"type": "string"
},
"tag_id": {
"description": "The tag ID to delete.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"tag_id"
],
"type": "object"
},
"name": "delete_tag",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Inspect the current guest/free/pro account status, remaining quota, and feature availability.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_account_status",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Get a single short link by alias for the current registered account.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "The link alias to fetch.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "The link domain. Defaults to miniurl.com.",
"format": "hostname",
"type": "string"
}
},
"required": [
"alias"
],
"type": "object"
},
"name": "get_link",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Get link analytics. Free accounts receive a basic total plus an upgrade hint; Pro accounts receive full breakdowns.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "The alias to inspect.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "Optional domain to scope the alias lookup. Defaults to miniurl.com.",
"format": "hostname",
"type": "string"
},
"period": {
"description": "Analytics time range. Defaults to 7D.",
"enum": [
"24H",
"7D",
"30D",
"ALL"
],
"type": "string"
}
},
"required": [
"alias"
],
"type": "object"
},
"name": "get_link_stats",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"clicks": {
"type": "array"
},
"total_clicks": {
"type": "integer"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "List domains available to the current registered account, including miniurl.com and active custom domains.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_domains",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"domains": {
"type": "array"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "List short links for the current registered account.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Opaque cursor returned as next_cursor. Prefer cursor pagination for stable traversal.",
"type": "string"
},
"domain": {
"description": "Optional domain filter.",
"format": "hostname",
"type": "string"
},
"limit": {
"description": "Optional page size. Defaults to 20.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Optional zero-based offset for pagination. Defaults to 0.",
"minimum": 0,
"type": "integer"
},
"search": {
"description": "Optional search term for alias or destination URL.",
"type": "string"
}
},
"type": "object"
},
"name": "list_links",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"links": {
"type": "array"
},
"pagination": {
"type": "object"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "List all tags for the current registered account. Tags help organise links into campaigns or categories.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_tags",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"tags": {
"type": "array"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Send a 6-digit registration code to the user email, using the current guest session.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email": {
"description": "The user email address.",
"format": "email",
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"name": "send_registration_code",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"activated_at": {
"description": "Optional ISO 8601 activation datetime. Requires Pro.",
"format": "date-time",
"type": "string"
},
"alias": {
"description": "Optional custom alias. Call check_alias before creating it. Requires a registered account; miniurl.com aliases must be at least 4 characters.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "Optional domain. Requires a registered account with an active custom domain.",
"format": "hostname",
"type": "string"
},
"dry_run": {
"description": "Validate the destination and show the planned link without creating it. Agent tokens only.",
"type": "boolean"
},
"expiration": {
"description": "Optional ISO 8601 expiration datetime. Requires Pro.",
"format": "date-time",
"type": "string"
},
"idempotency_key": {
"description": "Optional idempotency key. Reusing it with the same payload safely replays the original result.",
"maxLength": 128,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"type": "string"
},
"password": {
"description": "Optional password. Requires Pro.",
"type": "string"
},
"url": {
"description": "The HTTP or HTTPS destination URL to shorten.",
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "shorten_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"alias": {
"type": "string"
},
"domain": {
"type": "string"
},
"full_url": {
"type": "string"
},
"short_url": {
"type": "string"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Create a shortened checkout link for upgrading the current registered account to Pro.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"approval_id": {
"description": "Approval id returned by a previous USER_APPROVAL_REQUIRED response.",
"type": "string"
},
"approval_token": {
"description": "Legacy compatibility field; normally omit it and retry with approval_id after approval.",
"type": "string"
},
"idempotency_key": {
"maxLength": 128,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"type": "string"
},
"interval": {
"description": "Billing interval. Defaults to monthly.",
"enum": [
"monthly",
"yearly"
],
"type": "string"
}
},
"type": "object"
},
"name": "start_pro_upgrade",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"properties": {
"checkout_url": {
"type": "string"
},
"interval": {
"type": "string"
}
},
"type": "object"
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Add a tag to a short link for campaign or category organisation.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "The link alias to tag.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "The link domain. Defaults to miniurl.com.",
"format": "hostname",
"type": "string"
},
"tag_id": {
"description": "The tag ID to assign.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"alias",
"tag_id"
],
"type": "object"
},
"name": "tag_link",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Remove a tag from a short link.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "The link alias.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "The link domain. Defaults to miniurl.com.",
"format": "hostname",
"type": "string"
},
"tag_id": {
"description": "The tag ID to remove.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"alias",
"tag_id"
],
"type": "object"
},
"name": "untag_link",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Update a registered short link. Some fields require Pro.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"activated_at": {
"description": "Set a new ISO 8601 activation datetime. Requires Pro.",
"format": "date-time",
"type": "string"
},
"alias": {
"description": "The link alias to update.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"clear_activated_at": {
"description": "Clear the current scheduled activation datetime.",
"type": "boolean"
},
"clear_expiration": {
"description": "Clear the current expiration.",
"type": "boolean"
},
"clear_password": {
"description": "Remove the current password.",
"type": "boolean"
},
"domain": {
"description": "The link domain. Defaults to miniurl.com.",
"format": "hostname",
"type": "string"
},
"dry_run": {
"description": "Validate and preview the update without changing the link. Agent tokens only.",
"type": "boolean"
},
"expiration": {
"description": "Set a new ISO 8601 expiration datetime. Requires Pro.",
"format": "date-time",
"type": "string"
},
"idempotency_key": {
"maxLength": 128,
"minLength": 8,
"pattern": "^[A-Za-z0-9._:-]{8,128}$",
"type": "string"
},
"password": {
"description": "Set or replace the password. Requires Pro.",
"type": "string"
},
"url": {
"description": "New HTTP or HTTPS destination URL. Requires Pro.",
"format": "uri",
"type": "string"
}
},
"required": [
"alias"
],
"type": "object"
},
"name": "update_link",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "Refresh custom-domain DNS and SSL verification status. Agent domain changes require human approval by default.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"approval_id": {
"type": "string"
},
"approval_token": {
"description": "Legacy compatibility field; normally omit it.",
"type": "string"
},
"domain_id": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"domain_id"
],
"type": "object"
},
"name": "verify_domain",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"code": {
"description": "The 6-digit verification code.",
"pattern": "^\\d{6}$",
"type": "string"
},
"email": {
"description": "The user email address.",
"format": "email",
"type": "string"
}
},
"required": [
"email",
"code"
],
"type": "object"
},
"name": "verify_registration_code",
"outputSchema": {
"additionalProperties": false,
"properties": {
"approval": {
"additionalProperties": true,
"type": "object"
},
"data": {
"additionalProperties": true,
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"error": {
"oneOf": [
{
"type": "string"
},
{
"additionalProperties": true,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"code",
"message",
"retryable"
],
"type": "object"
}
]
},
"meta": {
"additionalProperties": true,
"type": "object"
},
"next_actions": {
"items": {
"type": "string"
},
"type": "array"
},
"request_id": {
"minLength": 8,
"type": "string"
},
"required_scope": {
"type": "string"
},
"retry_after": {
"minimum": 0,
"type": "integer"
},
"retryable": {
"type": "boolean"
},
"success": {
"type": "boolean"
},
"user_action_required": {
"type": "boolean"
}
},
"required": [
"success",
"request_id"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:8be925831c29cb87bfbc2c72a38e1c21133a381bad28b4f268ac649611f03eb4 | sha256sum