Skip to main content
Glama

QR code · 二维码图片(短.在线)

create_qr
Idempotent

为已有短链返回二维码。新目标须先 shorten_url 再调用本工具。需已注册的所有者。不新建短链,不抓取目标地址。编码带 ?s=qr 的 ASCII 短链,与 GET /v1/links/{id}/qr 相同。image_url 不是 API 密钥、OAuth 令牌或会话。 QR for an existing short link you own. For a new destination, call shorten_url first, then create_qr. Does not create a link or fetch the destination. Encodes the ASCII short link with ?s=qr, same as GET /v1/links/{id}/qr. image_url is not an API key, OAuth token, or session.

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "example"
    },
    "name": "create_qr"
  }
}

Input Schema

NameRequiredDescriptionDefault
idNoNot with short_url
sizeNoPNG side.
formatNoDefault png 512. svg is not an image block and ignores size.
short_urlNoNot with id

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • changedInput schema / properties / format / description
      Previous value: -"Image format. Default png. svg only when requested. SVG ignores size."New value: +"Default png 512. svg is not an image block and ignores size."
    • changedInput schema / properties / id / description
      Previous value: -"Existing short code. Mutually exclusive with short_url."New value: +"Not with short_url"
    • changedInput schema / properties / short_url / description
      Previous value: -"Existing short URL to tag for QR. Mutually exclusive with id."New value: +"Not with id"
    • changedInput schema / properties / size / description
      Previous value: -"PNG square pixels. Default 512. Allowed: 256, 512, or 1024. Ignored when format is svg."New value: +"PNG side."
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "host_display": {
      -        "description": "Neutral summary of the returned QR: format, the encoded qr_tracking_url, and image_url availability.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": true,
      -        "description": "True only when a PNG image block is included.",
      -        "type": "boolean"
      -      },
      -      "image_url": {
      -        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      -        "type": "string"
      -      },
      -      "image_url_expires_at": {
      -        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      -        "type": "string"
      -      },
      -      "mime_type": {
      -        "const": "image/png",
      -        "description": "image/png. A PNG image block is included.",
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "pixel_size": {
      -        "anyOf": [
      -          {
      -            "const": 256,
      -            "type": "number"
      -          },
      -          {
      -            "const": 512,
      -            "type": "number"
      -          },
      -          {
      -            "const": 1024,
      -            "type": "number"
      -          }
      -        ],
      -        "description": "PNG square pixels."
      -      },
      -      "qr_tracking_url": {
      -        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "short_url": {
      -        "type": "string"
      -      },
      -      "short_url_ascii": {
      -        "type": "string"
      -      },
      -      "state": {
      -        "const": "active",
      -        "type": "string"
      -      },
      -      "status_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "id",
      -      "state",
      -      "short_url",
      -      "short_url_ascii",
      -      "qr_tracking_url",
      -      "status_url",
      -      "host_display",
      -      "mime_type",
      -      "pixel_size",
      -      "image_available"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "host_display": {
      -        "description": "Neutral summary of the returned QR: format, the encoded qr_tracking_url, and image_url availability.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": false,
      -        "description": "False for SVG. Hosts do not render an SVG image block. Use the SVG text, resource, or image_url.",
      -        "type": "boolean"
      -      },
      -      "image_url": {
      -        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      -        "type": "string"
      -      },
      -      "image_url_expires_at": {
      -        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      -        "type": "string"
      -      },
      -      "mime_type": {
      -        "const": "image/svg+xml",
      -        "description": "image/svg+xml. SVG is not sent as an image block.",
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "pixel_size": {
      -        "description": "Null for SVG.",
      -        "type": "null"
      -      },
      -      "qr_tracking_url": {
      -        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "short_url": {
      -        "type": "string"
      -      },
      -      "short_url_ascii": {
      -        "type": "string"
      -      },
      -      "state": {
      -        "const": "active",
      -        "type": "string"
      -      },
      -      "status_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "id",
      -      "state",
      -      "short_url",
      -      "short_url_ascii",
      -      "qr_tracking_url",
      -      "status_url",
      -      "host_display",
      -      "mime_type",
      -      "pixel_size",
      -      "image_available"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "code": {
      -        "type": "string"
      -      },
      -      "error": {
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "message": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "retryable": {
      -        "type": "boolean"
      -      },
      -      "state": {
      -        "enum": [
      -          "quarantined",
      -          "disabled",
      -          "blocked",
      -          "expired"
      -        ],
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "type": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "message",
      -      "type",
      -      "title",
      -      "code",
      -      "retryable"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "host_display": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "image_url": {
      +        "description": "Omitted if unsigned.",
      +        "type": "string"
      +      },
      +      "image_url_expires_at": {
      +        "type": "string"
      +      },
      +      "mime_type": {
      +        "const": "image/png",
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "pixel_size": {
      +        "anyOf": [
      +          {
      +            "const": 256,
      +            "type": "number"
      +          },
      +          {
      +            "const": 512,
      +            "type": "number"
      +          },
      +          {
      +            "const": 1024,
      +            "type": "number"
      +          }
      +        ]
      +      },
      +      "qr_tracking_url": {
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "short_url": {
      +        "type": "string"
      +      },
      +      "short_url_ascii": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "active",
      +        "type": "string"
      +      },
      +      "status_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "id",
      +      "state",
      +      "short_url",
      +      "short_url_ascii",
      +      "qr_tracking_url",
      +      "status_url",
      +      "host_display",
      +      "mime_type",
      +      "pixel_size",
      +      "image_available"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "host_display": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "image_url": {
      +        "description": "Omitted if unsigned.",
      +        "type": "string"
      +      },
      +      "image_url_expires_at": {
      +        "type": "string"
      +      },
      +      "mime_type": {
      +        "const": "image/svg+xml",
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "pixel_size": {
      +        "type": "null"
      +      },
      +      "qr_tracking_url": {
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "short_url": {
      +        "type": "string"
      +      },
      +      "short_url_ascii": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "active",
      +        "type": "string"
      +      },
      +      "status_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "id",
      +      "state",
      +      "short_url",
      +      "short_url_ascii",
      +      "qr_tracking_url",
      +      "status_url",
      +      "host_display",
      +      "mime_type",
      +      "pixel_size",
      +      "image_available"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "code": {
      +        "type": "string"
      +      },
      +      "error": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "state": {
      +        "enum": [
      +          "quarantined",
      +          "disabled",
      +          "blocked",
      +          "expired"
      +        ],
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "message",
      +      "type",
      +      "title",
      +      "code",
      +      "retryable"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "host_display": {
      -        "description": "Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": true,
      -        "description": "True only when a PNG image block is included.",
      -        "type": "boolean"
      -      },
      -      "image_url": {
      -        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      -        "type": "string"
      -      },
      -      "image_url_expires_at": {
      -        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      -        "type": "string"
      -      },
      -      "mime_type": {
      -        "const": "image/png",
      -        "description": "image/png. A PNG image block is included.",
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "pixel_size": {
      -        "anyOf": [
      -          {
      -            "const": 256,
      -            "type": "number"
      -          },
      -          {
      -            "const": 512,
      -            "type": "number"
      -          },
      -          {
      -            "const": 1024,
      -            "type": "number"
      -          }
      -        ],
      -        "description": "PNG square pixels."
      -      },
      -      "qr_tracking_url": {
      -        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "short_url": {
      -        "type": "string"
      -      },
      -      "short_url_ascii": {
      -        "type": "string"
      -      },
      -      "state": {
      -        "const": "active",
      -        "type": "string"
      -      },
      -      "status_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "id",
      -      "state",
      -      "short_url",
      -      "short_url_ascii",
      -      "qr_tracking_url",
      -      "status_url",
      -      "host_display",
      -      "mime_type",
      -      "pixel_size",
      -      "image_available"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "host_display": {
      -        "description": "Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code.",
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": false,
      -        "description": "False for SVG. Hosts do not render an SVG image block. Use the SVG text, resource, or image_url.",
      -        "type": "boolean"
      -      },
      -      "image_url": {
      -        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      -        "type": "string"
      -      },
      -      "image_url_expires_at": {
      -        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      -        "type": "string"
      -      },
      -      "mime_type": {
      -        "const": "image/svg+xml",
      -        "description": "image/svg+xml. SVG is not sent as an image block.",
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "pixel_size": {
      -        "description": "Null for SVG.",
      -        "type": "null"
      -      },
      -      "qr_tracking_url": {
      -        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "short_url": {
      -        "type": "string"
      -      },
      -      "short_url_ascii": {
      -        "type": "string"
      -      },
      -      "state": {
      -        "const": "active",
      -        "type": "string"
      -      },
      -      "status_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "id",
      -      "state",
      -      "short_url",
      -      "short_url_ascii",
      -      "qr_tracking_url",
      -      "status_url",
      -      "host_display",
      -      "mime_type",
      -      "pixel_size",
      -      "image_available"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "code": {
      -        "type": "string"
      -      },
      -      "error": {
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "message": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "retryable": {
      -        "type": "boolean"
      -      },
      -      "state": {
      -        "enum": [
      -          "quarantined",
      -          "disabled",
      -          "blocked",
      -          "expired"
      -        ],
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "type": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "message",
      -      "type",
      -      "title",
      -      "code",
      -      "retryable"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "host_display": {
      +        "description": "Neutral summary of the returned QR: format, the encoded qr_tracking_url, and image_url availability.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": true,
      +        "description": "True only when a PNG image block is included.",
      +        "type": "boolean"
      +      },
      +      "image_url": {
      +        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      +        "type": "string"
      +      },
      +      "image_url_expires_at": {
      +        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      +        "type": "string"
      +      },
      +      "mime_type": {
      +        "const": "image/png",
      +        "description": "image/png. A PNG image block is included.",
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "pixel_size": {
      +        "anyOf": [
      +          {
      +            "const": 256,
      +            "type": "number"
      +          },
      +          {
      +            "const": 512,
      +            "type": "number"
      +          },
      +          {
      +            "const": 1024,
      +            "type": "number"
      +          }
      +        ],
      +        "description": "PNG square pixels."
      +      },
      +      "qr_tracking_url": {
      +        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "short_url": {
      +        "type": "string"
      +      },
      +      "short_url_ascii": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "active",
      +        "type": "string"
      +      },
      +      "status_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "id",
      +      "state",
      +      "short_url",
      +      "short_url_ascii",
      +      "qr_tracking_url",
      +      "status_url",
      +      "host_display",
      +      "mime_type",
      +      "pixel_size",
      +      "image_available"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "host_display": {
      +        "description": "Neutral summary of the returned QR: format, the encoded qr_tracking_url, and image_url availability.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": false,
      +        "description": "False for SVG. Hosts do not render an SVG image block. Use the SVG text, resource, or image_url.",
      +        "type": "boolean"
      +      },
      +      "image_url": {
      +        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      +        "type": "string"
      +      },
      +      "image_url_expires_at": {
      +        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      +        "type": "string"
      +      },
      +      "mime_type": {
      +        "const": "image/svg+xml",
      +        "description": "image/svg+xml. SVG is not sent as an image block.",
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "pixel_size": {
      +        "description": "Null for SVG.",
      +        "type": "null"
      +      },
      +      "qr_tracking_url": {
      +        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "short_url": {
      +        "type": "string"
      +      },
      +      "short_url_ascii": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "active",
      +        "type": "string"
      +      },
      +      "status_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "id",
      +      "state",
      +      "short_url",
      +      "short_url_ascii",
      +      "qr_tracking_url",
      +      "status_url",
      +      "host_display",
      +      "mime_type",
      +      "pixel_size",
      +      "image_available"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "code": {
      +        "type": "string"
      +      },
      +      "error": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "state": {
      +        "enum": [
      +          "quarantined",
      +          "disabled",
      +          "blocked",
      +          "expired"
      +        ],
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "message",
      +      "type",
      +      "title",
      +      "code",
      +      "retryable"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "mime_type": {
      -        "description": "image/png or image/svg+xml.",
      -        "enum": [
      -          "image/png",
      -          "image/svg+xml"
      -        ],
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "pixel_size": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "PNG square pixels. Null for SVG."
      -      },
      -      "qr_tracking_url": {
      -        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "short_url": {
      -        "type": "string"
      -      },
      -      "short_url_ascii": {
      -        "type": "string"
      -      },
      -      "state": {
      -        "const": "active",
      -        "type": "string"
      -      },
      -      "status_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "id",
      -      "state",
      -      "short_url",
      -      "short_url_ascii",
      -      "qr_tracking_url",
      -      "status_url",
      -      "mime_type",
      -      "pixel_size",
      -      "image_available"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "code": {
      -        "type": "string"
      -      },
      -      "error": {
      -        "type": "string"
      -      },
      -      "id": {
      -        "type": "string"
      -      },
      -      "image_available": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "message": {
      -        "type": "string"
      -      },
      -      "ok": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "request_id": {
      -        "type": "string"
      -      },
      -      "retryable": {
      -        "type": "boolean"
      -      },
      -      "state": {
      -        "enum": [
      -          "quarantined",
      -          "disabled",
      -          "blocked",
      -          "expired"
      -        ],
      -        "type": "string"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "type": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "request_id",
      -      "message",
      -      "type",
      -      "title",
      -      "code",
      -      "retryable"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "host_display": {
      +        "description": "Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": true,
      +        "description": "True only when a PNG image block is included.",
      +        "type": "boolean"
      +      },
      +      "image_url": {
      +        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      +        "type": "string"
      +      },
      +      "image_url_expires_at": {
      +        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      +        "type": "string"
      +      },
      +      "mime_type": {
      +        "const": "image/png",
      +        "description": "image/png. A PNG image block is included.",
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "pixel_size": {
      +        "anyOf": [
      +          {
      +            "const": 256,
      +            "type": "number"
      +          },
      +          {
      +            "const": 512,
      +            "type": "number"
      +          },
      +          {
      +            "const": 1024,
      +            "type": "number"
      +          }
      +        ],
      +        "description": "PNG square pixels."
      +      },
      +      "qr_tracking_url": {
      +        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "short_url": {
      +        "type": "string"
      +      },
      +      "short_url_ascii": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "active",
      +        "type": "string"
      +      },
      +      "status_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "id",
      +      "state",
      +      "short_url",
      +      "short_url_ascii",
      +      "qr_tracking_url",
      +      "status_url",
      +      "host_display",
      +      "mime_type",
      +      "pixel_size",
      +      "image_available"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "host_display": {
      +        "description": "Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code.",
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": false,
      +        "description": "False for SVG. Hosts do not render an SVG image block. Use the SVG text, resource, or image_url.",
      +        "type": "boolean"
      +      },
      +      "image_url": {
      +        "description": "Short-lived URL for this QR image. Omitted when signing is not configured. Not an API key, OAuth token, or session.",
      +        "type": "string"
      +      },
      +      "image_url_expires_at": {
      +        "description": "ISO-8601 expiry of image_url. Present only together with image_url.",
      +        "type": "string"
      +      },
      +      "mime_type": {
      +        "const": "image/svg+xml",
      +        "description": "image/svg+xml. SVG is not sent as an image block.",
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "pixel_size": {
      +        "description": "Null for SVG.",
      +        "type": "null"
      +      },
      +      "qr_tracking_url": {
      +        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "short_url": {
      +        "type": "string"
      +      },
      +      "short_url_ascii": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "active",
      +        "type": "string"
      +      },
      +      "status_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "id",
      +      "state",
      +      "short_url",
      +      "short_url_ascii",
      +      "qr_tracking_url",
      +      "status_url",
      +      "host_display",
      +      "mime_type",
      +      "pixel_size",
      +      "image_available"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "code": {
      +        "type": "string"
      +      },
      +      "error": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "state": {
      +        "enum": [
      +          "quarantined",
      +          "disabled",
      +          "blocked",
      +          "expired"
      +        ],
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "message",
      +      "type",
      +      "title",
      +      "code",
      +      "retryable"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / oneOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "mime_type": {
      +        "description": "image/png or image/svg+xml.",
      +        "enum": [
      +          "image/png",
      +          "image/svg+xml"
      +        ],
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "pixel_size": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "PNG square pixels. Null for SVG."
      +      },
      +      "qr_tracking_url": {
      +        "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "short_url": {
      +        "type": "string"
      +      },
      +      "short_url_ascii": {
      +        "type": "string"
      +      },
      +      "state": {
      +        "const": "active",
      +        "type": "string"
      +      },
      +      "status_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "id",
      +      "state",
      +      "short_url",
      +      "short_url_ascii",
      +      "qr_tracking_url",
      +      "status_url",
      +      "mime_type",
      +      "pixel_size",
      +      "image_available"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "code": {
      +        "type": "string"
      +      },
      +      "error": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "image_available": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "message": {
      +        "type": "string"
      +      },
      +      "ok": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "request_id": {
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "state": {
      +        "enum": [
      +          "quarantined",
      +          "disabled",
      +          "blocked",
      +          "expired"
      +        ],
      +        "type": "string"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "request_id",
      +      "message",
      +      "type",
      +      "title",
      +      "code",
      +      "retryable"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties
      Removed value: -{
      -  "code": {
      -    "type": "string"
      -  },
      -  "error": {
      -    "type": "string"
      -  },
      -  "id": {
      -    "type": "string"
      -  },
      -  "image_available": {
      -    "type": "boolean"
      -  },
      -  "message": {
      -    "type": "string"
      -  },
      -  "mime_type": {
      -    "description": "image/png or image/svg+xml.",
      -    "type": "string"
      -  },
      -  "ok": {
      -    "type": "boolean"
      -  },
      -  "pixel_size": {
      -    "anyOf": [
      -      {
      -        "maximum": 9007199254740991,
      -        "minimum": -9007199254740991,
      -        "type": "integer"
      -      },
      -      {
      -        "type": "null"
      -      }
      -    ],
      -    "description": "PNG square pixels. Null for SVG."
      -  },
      -  "qr_tracking_url": {
      -    "description": "ASCII tracking URL encoded in the image, including ?s=qr.",
      -    "type": "string"
      -  },
      -  "request_id": {
      -    "type": "string"
      -  },
      -  "retryable": {
      -    "type": "boolean"
      -  },
      -  "short_url": {
      -    "type": "string"
      -  },
      -  "short_url_ascii": {
      -    "type": "string"
      -  },
      -  "state": {
      -    "type": "string"
      -  },
      -  "status_url": {
      -    "type": "string"
      -  },
      -  "title": {
      -    "type": "string"
      -  },
      -  "type": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "ok",
      -  "request_id"
      -]
  5. Changed10 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / examples
      Previous value: -[
      -  {
      -    "id": "example"
      -  },
      -  {
      -    "short_url": "https://xn--s7y.xn--3ds443g/example"
      -  }
      -]New value: +[
      +  {
      +    "id": "example"
      +  },
      +  {
      +    "short_url": "https://xn--s7y.xn--3ds443g/example"
      +  },
      +  {
      +    "format": "png",
      +    "id": "example",
      +    "size": 512
      +  }
      +]
    • removedInput schema / oneOf
      Removed value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "id": {
      -        "description": "Existing short code. Mutually exclusive with short_url.",
      -        "maxLength": 64,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "short_url": {
      -        "description": "Existing short URL to tag for QR. Mutually exclusive with id.",
      -        "maxLength": 2048,
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "short_url"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedInput schema / properties
      Added value: +{
      +  "format": {
      +    "description": "Image format. Default png. svg only when requested. SVG ignores size.",
      +    "enum": [
      +      "png",
      +      "svg"
      +    ],
      +    "type": "string"
      +  },
      +  "id": {
      +    "description": "Existing short code. Mutually exclusive with short_url.",
      +    "maxLength": 64,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "short_url": {
      +    "description": "Existing short URL to tag for QR. Mutually exclusive with id.",
      +    "maxLength": 2048,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "size": {
      +    "anyOf": [
      +      {
      +        "const": 256,
      +        "type": "number"
      +      },
      +      {
      +        "const": 512,
      +        "type": "number"
      +      },
      +      {
      +        "const": 1024,
      +        "type": "number"
      +      }
      +    ],
      +    "description": "PNG square pixels. Default 512. Allowed: 256, 512, or 1024. Ignored when format is svg."
      +  }
      +}
    • addedOutput schema / properties / mime_type
      Added value: +{
      +  "description": "image/png or image/svg+xml.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / pixel_size
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "PNG square pixels. Null for SVG."
      +}
    • addedOutput schema / properties / qr_tracking_url / description
      Added value: +"ASCII tracking URL encoded in the image, including ?s=qr."
    • addedOutput schema / properties / status_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / title
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / type
      Added value: +{
      +  "type": "string"
      +}
  6. Changed3 schema fields changed
    • changedInput schema / examples
      Previous value: -[
      -  {
      -    "id": "example"
      -  },
      -  {
      -    "short_url": "https://example.com/example"
      -  }
      -]New value: +[
      +  {
      +    "id": "example"
      +  },
      +  {
      +    "short_url": "https://xn--s7y.xn--3ds443g/example"
      +  }
      +]
    • addedInput schema / oneOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "id": {
      +        "description": "Existing short code. Mutually exclusive with short_url.",
      +        "maxLength": 64,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "short_url": {
      +        "description": "Existing short URL to tag for QR. Mutually exclusive with id.",
      +        "maxLength": 2048,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "short_url"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties
      Removed value: -{
      -  "id": {
      -    "description": "Existing short code",
      -    "maxLength": 64,
      -    "minLength": 1,
      -    "type": "string"
      -  },
      -  "short_url": {
      -    "description": "Existing short URL to tag for QR",
      -    "maxLength": 2048,
      -    "minLength": 1,
      -    "type": "string"
      -  }
      -}
  7. Changed1 schema field changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "id": "example"
      +  },
      +  {
      +    "short_url": "https://example.com/example"
      +  }
      +]
  8. Changed11 schema fields changed
    • removedInput schema / properties / format
      Removed value: -{
      -  "description": "Preferred image format (PNG always embedded; SVG via resource link)",
      -  "enum": [
      -    "png",
      -    "svg"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / id / description
      Previous value: -"Short code of a link you own"New value: +"Existing short code"
    • changedInput schema / properties / short_url / description
      Previous value: -"Owned short URL (Unicode or punycode)"New value: +"Existing short URL to tag for QR"
    • removedInput schema / properties / short_url_ascii
      Removed value: -{
      -  "description": "Owned short URL in punycode form",
      -  "maxLength": 2048,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / size
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "const": 256,
      -      "type": "number"
      -    },
      -    {
      -      "const": 512,
      -      "type": "number"
      -    },
      -    {
      -      "const": 1024,
      -      "type": "number"
      -    }
      -  ],
      -  "description": "PNG pixel size: 256, 512 (default), or 1024"
      -}
    • removedOutput schema / properties / format
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / image_mime_type
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / qr_image_svg_url
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / qr_image_url
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / size
      Removed value: -{
      -  "type": "number"
      -}
    • removedOutput schema / properties / status_url
      Removed value: -{
      -  "type": "string"
      -}
  9. Changed11 schema fields changed
    • addedInput schema / properties / format
      Added value: +{
      +  "description": "Preferred image format (PNG always embedded; SVG via resource link)",
      +  "enum": [
      +    "png",
      +    "svg"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / id / description
      Previous value: -"Existing short code"New value: +"Short code of a link you own"
    • changedInput schema / properties / short_url / description
      Previous value: -"Existing short URL to tag for QR"New value: +"Owned short URL (Unicode or punycode)"
    • addedInput schema / properties / short_url_ascii
      Added value: +{
      +  "description": "Owned short URL in punycode form",
      +  "maxLength": 2048,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / size
      Added value: +{
      +  "anyOf": [
      +    {
      +      "const": 256,
      +      "type": "number"
      +    },
      +    {
      +      "const": 512,
      +      "type": "number"
      +    },
      +    {
      +      "const": 1024,
      +      "type": "number"
      +    }
      +  ],
      +  "description": "PNG pixel size: 256, 512 (default), or 1024"
      +}
    • addedOutput schema / properties / format
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / image_mime_type
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / qr_image_svg_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / qr_image_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / size
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / status_url
      Added value: +{
      +  "type": "string"
      +}
  10. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only cover the safety profile (readOnlyHint=false, idempotentHint=true, openWorldHint=true, destructiveHint=false); the description adds ownership requirements, confirms no link is created and no destination is fetched, specifies the exact payload encoded ('?s=qr'), and notes equivalence to REST GET /v1/links/{id}/qr. It even flags that image_url is not a credential, which is behavioral context the annotations cannot convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Sentences are front-loaded and each carries weight (purpose, prerequisite, alternative, exclusions, encoding, security caveat). The full bilingual duplication roughly doubles the length without adding new information for an English-reading agent, which is the main efficiency cost.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return shape needn't be explained, and the description covers everything else an agent needs: ownership, the prerequisite chain to shorten_url, side-effect boundaries, and the exact encoded content. Nothing material is missing for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so id, short_url, size, and format are already documented in the schema (including the id/short_url mutual exclusion and svg ignoring size). The description adds only the ?s=qr encoding detail, not parameter-level guidance, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('returns a QR code for an existing short link you own'), and immediately contrasts it with sibling shorten_url, which creates links. An agent can distinguish it from shorten_url, get_link, and resolve_short_url without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit routing: 'For a new destination, call shorten_url first, then create_qr', plus the ownership prerequisite ('Needs a registered owner'). It also states exclusions ('Does not create a link or fetch the destination'), so both when-to-use and when-not are covered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources