Quality QR

Create a new trackable QR code saved to your Quality QR account. Use this when the user wants to generate a QR code for a URL, WiFi network, contact card, calendar event, phone number, email, SMS, restaurant menu, app download link, or social media profile. The QR code is persisted with scan tracking and analytics. Returns an inline SVG image of the QR code.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "url",
        "pdf",
        "menu",
        "app-store",
        "social",
        "wifi",
        "vcard",
        "email",
        "phone",
        "sms",
        "text",
        "event"
      ],
      "description": "QR code content type. 'url' for websites, 'wifi' for network credentials, 'vcard' for contact cards, 'email' for pre-filled emails, 'phone' for tap-to-call, 'sms' for pre-filled texts, 'text' for plain text, 'event' for calendar events, 'pdf' for document links, 'menu' for restaurant menus, 'app-store' for app download links, 'social' for social media profiles."
    },
    "content": {
      "type": "string",
      "description": "The content to encode. Required for url, text, pdf, menu, and app-store types. For url types, provide the full URL including https://. For other types, use the 'data' parameter instead."
    },
    "name": {
      "type": "string",
      "description": "A human-readable name for the QR code, e.g. 'Office WiFi' or 'Spring Menu 2026'. Auto-generated as 'MCP: {type} {date}' if omitted."
    },
    "isDynamic": {
      "type": "boolean",
      "description": "Set to true to create a dynamic QR code whose destination URL can be changed later without reprinting the physical code. Only works for URL-based types (url, pdf, menu, app-store, social). Default: false."
    },
    "data": {
      "type": "object",
      "description": "Type-specific structured data. Use instead of 'content' for complex types. WiFi: {ssid: string, password?: string, encryption?: 'WPA'|'WEP'|'nopass', hidden?: boolean}. vCard: {firstName: string, lastName: string, email?: string, phone?: string, mobile?: string, organization?: string, title?: string, website?: string, address?: {street?, city?, state?, zip?, country?}}. Event: {title: string, startDate: string (YYYY-MM-DD), startTime?: string (HH:mm), endDate?: string, endTime?: string, location?: string, description?: string, allDay?: boolean}. Social: {platforms: [{name: string, url: string, label: string}], profileName?: string, bio?: string}. Email: {to: string, subject?: string, body?: string}. Phone: {number: string}. SMS: {number: string, message?: string}."
    },
    "design": {
      "type": "object",
      "description": "Optional visual customization for the QR code.",
      "properties": {
        "foregroundColor": {
          "type": "string",
          "description": "Hex color code for the QR code modules (dark squares), e.g. '#000000' for black or '#1a56db' for blue."
        },
        "backgroundColor": {
          "type": "string",
          "description": "Hex color code for the QR code background, e.g. '#ffffff' for white."
        }
      }
    }
  },
  "required": [
    "type"
  ]
}

List QR codes in the user's Quality QR account. Use this when the user wants to see their existing QR codes, find a specific code, or check how many codes they have. Returns ID, name, type, short URL, active status, and creation date for each code.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "url",
        "pdf",
        "menu",
        "app-store",
        "social",
        "wifi",
        "vcard",
        "email",
        "phone",
        "sms",
        "text",
        "event"
      ],
      "description": "Filter results to only QR codes of this type. Omit to return all types."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of results to return. Default: 50, maximum: 100.",
      "default": 50
    },
    "offset": {
      "type": "number",
      "description": "Number of results to skip for pagination. Default: 0.",
      "default": 0
    }
  }
}

Get full details of a specific QR code by its ID. Use this when the user wants to inspect a particular QR code's configuration, check its destination URL, view its design settings, or see its current status. Returns all metadata including content, destination, design, scan limits, and timestamps.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier of the QR code. Obtain this from quality_qr_list or quality_qr_create responses."
    }
  },
  "required": [
    "id"
  ]
}

Update an existing QR code's properties. Use this when the user wants to change where a QR code points to, rename it, or enable/disable it. Destination URL changes only work for dynamic URL-based types (url, pdf, menu, app-store, social). Name and active status can be changed for any QR code type.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier of the QR code to update. Obtain this from quality_qr_list or quality_qr_create responses."
    },
    "destinationUrl": {
      "type": "string",
      "description": "New destination URL. Only works for dynamic URL-based types (url, pdf, menu, app-store, social). The physical QR code does not need reprinting."
    },
    "name": {
      "type": "string",
      "description": "New human-readable name for the QR code."
    },
    "isActive": {
      "type": "boolean",
      "description": "Set to false to disable the QR code (scans will stop redirecting). Set to true to re-enable it."
    }
  },
  "required": [
    "id"
  ]
}

Permanently delete a QR code from the user's account. Use this when the user wants to remove a QR code they no longer need. The short URL will immediately stop redirecting. This action frees up a plan quota slot and cannot be undone.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier of the QR code to permanently delete. Obtain this from quality_qr_list or quality_qr_create responses."
    }
  },
  "required": [
    "id"
  ]
}

Get scan analytics for a specific QR code. Use this when the user wants to know how many times a QR code has been scanned, see daily scan trends, understand which devices are scanning, or see which countries scans come from. Returns total scans, scans by day, device breakdown (mobile/tablet/desktop), and top 5 countries.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier of the QR code to get analytics for. Obtain this from quality_qr_list or quality_qr_create responses."
    },
    "days": {
      "type": "number",
      "description": "Number of days of scan history to retrieve. Default: 30. Capped by plan: Free tier = 7 days max, Pro = 30 days, Business = 365 days.",
      "default": 30
    }
  },
  "required": [
    "id"
  ]
}