QRStuff MCP Server

Update QR code

update_qr_code

DestructiveIdempotent

Use this when the user wants to change a QR code already in their account: where a dynamic code points, its text or content, or its look (colours, shapes, logo, frame, size). Call get_qr_code_by_id first and send the full merged settings; this overwrites the saved settings. A static code that is already printed cannot change what it encodes. Do not use it to make a new code (use generate_qr_code).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "input": "<input>"
    },
    "name": "update_qr_code"
  }
}

Input Schema

Name	Required	Description	Default
`input`	Yes	The QR code ID plus the full merged settings to save. Send the current value unless you are changing it.

Schema Changelog

Changes observed during successful MCP inspections.

Changed57 schema fields changedOct 30, 2026

addedInput schema / properties / input / description

Added value: +"The QR code ID plus the full merged settings to save. Send the current value unless you are changing it."

addedInput schema / properties / input / properties / address

Added value: +{
+  "default": null,
+  "description": "Event address for 'VCALENDAR' type (exclusive with location)",
+  "type": "string"
+}

addedInput schema / properties / input / properties / advanced_settings

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Exact API top-level settings. Supported feature-gated keys include require_password, password, password_attempts_limit, password_failure_redirect, password_failure_message, password_failure_url, password_note, active, inactive_from, active_after, inactive_message, inactive_url, hit_limit_enabled, hit_limit, hit_limit_message, hit_limit_url, slack_settings, script, enable_gps_tracking, enable_geofencing_support, latitude, longitude, radius, remove_qrcode_time_limit. The API enforces plan entitlements and validation."
+}

addedInput schema / properties / input / properties / amount

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "number"
+    },
+    {
+      "type": "string"
+    }
+  ],
+  "default": null,
+  "description": "Optional amount for 'BITCOIN' type"
+}

addedInput schema / properties / input / properties / calling_code

Added value: +{
+  "default": null,
+  "description": "Country calling code for 'WHATSAPP' type, e.g. '+1'",
+  "type": "string"
+}

addedInput schema / properties / input / properties / cell_phone_number

Added value: +{
+  "default": null,
+  "description": "Mobile phone for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / city

Added value: +{
+  "default": null,
+  "description": "City for 'VCARD' type",
+  "type": "string"
+}

removedInput schema / properties / input / properties / colors / additionalProperties
```
Removed value: -true
```

changedInput schema / properties / input / properties / colors / description

Previous value: -"Colors object with keys: bg, fg, finder, finder_eye, alignment_inner, alignment_outer, gradient, center_text, transparent"New value: +"Colors object with specific hex values for QR styling"

addedInput schema / properties / input / properties / colors / properties

Added value: +{
+  "alignment_inner": {
+    "default": null,
+    "description": "Alignment inner color, hex",
+    "type": "string"
+  },
+  "alignment_outer": {
+    "default": null,
+    "description": "Alignment outer color, hex",
+    "type": "string"
+  },
+  "bg": {
+    "default": null,
+    "description": "Hex colour such as #ffffff. Keep strong contrast between fg and bg so the code scans.",
+    "type": "string"
+  },
+  "center_text": {
+    "default": null,
+    "description": "Center text color, hex",
+    "type": "string"
+  },
+  "fg": {
+    "default": null,
+    "description": "Hex colour such as #000000. Keep strong contrast between fg and bg so the code scans.",
+    "type": "string"
+  },
+  "finder": {
+    "default": null,
+    "description": "Finder color, hex",
+    "type": "string"
+  },
+  "finder_eye": {
+    "default": null,
+    "description": "Finder eye color, hex",
+    "type": "string"
+  },
+  "gradient": {
+    "default": null,
+    "description": "Gradient end color, hex",
+    "type": "string"
+  },
+  "transparent": {
+    "default": null,
+    "description": "Whether background is transparent",
+    "type": "boolean"
+  }
+}

addedInput schema / properties / input / properties / country

Added value: +{
+  "default": null,
+  "description": "Country for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / data / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / input / properties / data / description

Previous value: -"Primary data. For 'URL', pass the full URL; for 'TEXT', pass the text; for 'MAILTO' or 'TEL', pass the email or phone if you do not use the dedicated params."New value: +"The main value: the web address for URL, the text for TEXT, the phone number for TEL. For other types fill the dedicated fields (for example `ssid` and `wifi_password` for WIFI) or `data_fields`."

removedInput schema / properties / input / properties / data / type
```
Removed value: -"string"
```

addedInput schema / properties / input / properties / data_fields

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Exact datatype-specific data object. Use list_qr_data_types to discover required keys. When provided, this takes precedence over data and dedicated convenience fields."
+}

addedInput schema / properties / input / properties / email

Added value: +{
+  "default": null,
+  "description": "Email for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / end_date_time

Added value: +{
+  "default": null,
+  "description": "Event end, ISO 8601 with offset e.g. '2026-05-01T10:00:00+00:00'",
+  "type": "string"
+}

addedInput schema / properties / input / properties / error_correction_level / enum
```
Added value: +[
+  "L",
+  "M",
+  "Q",
+  "H"
+]
```

addedInput schema / properties / input / properties / event_name

Added value: +{
+  "default": null,
+  "description": "Event name for 'VCALENDAR' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / fax_number

Added value: +{
+  "default": null,
+  "description": "Fax number for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / first_name

Added value: +{
+  "default": null,
+  "description": "First name for 'VCARD' type",
+  "type": "string"
+}

changedInput schema / properties / input / properties / format / description

Previous value: -"Image format: 'png' or 'svg'"New value: +"QR output format supported by the API"

addedInput schema / properties / input / properties / format / enum

Added value: +[
+  "bmp",
+  "dxf",
+  "eps",
+  "gif",
+  "jpg",
+  "pdf",
+  "png",
+  "png8",
+  "svg",
+  "tiff",
+  "webp"
+]

addedInput schema / properties / input / properties / frame

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Frame object: type (frame-N), color, text and text_color"
+}

addedInput schema / properties / input / properties / gacampaign

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Google campaign object: source, medium, content and name"
+}

addedInput schema / properties / input / properties / idproject

Added value: +{
+  "default": null,
+  "description": "Project ID for the QR code",
+  "type": "integer"
+}

changedInput schema / properties / input / properties / idqrcode / description

Previous value: -"ID of the QR code to update"New value: +"ID of the QR code to update, from `list_qrcodes`. Never guess an ID."

addedInput schema / properties / input / properties / label

Added value: +{
+  "default": null,
+  "description": "Optional label for 'BITCOIN' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / last_name

Added value: +{
+  "default": null,
+  "description": "Last name for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / latitude

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "number"
+    },
+    {
+      "type": "string"
+    }
+  ],
+  "default": null,
+  "description": "Event latitude for 'VCALENDAR' type"
+}

addedInput schema / properties / input / properties / location

Added value: +{
+  "default": null,
+  "description": "Event location text for 'VCALENDAR' type (exclusive with address)",
+  "type": "string"
+}

addedInput schema / properties / input / properties / logo_multiplier

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "number"
+    }
+  ],
+  "default": null,
+  "description": "Logo size multiplier between 0.5 and 1.5"
+}

addedInput schema / properties / input / properties / longitude

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "number"
+    },
+    {
+      "type": "string"
+    }
+  ],
+  "default": null,
+  "description": "Event longitude for 'VCALENDAR' type"
+}

addedInput schema / properties / input / properties / metadata

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Up to 10 reporting metadata string key/value pairs"
+}

changedInput schema / properties / input / properties / module_shape / description
```
Previous value: -"Module shape, e.g., 'square'"New value: +"QR module shape"
```

addedInput schema / properties / input / properties / module_shape / enum

Added value: +[
+  "square",
+  "round",
+  "dot",
+  "square_outlined",
+  "square_rounded_connected",
+  "dots_connected",
+  "diamond",
+  "diamond_rounded",
+  "star_4_point",
+  "star_4_point_rounded",
+  "star_5_point",
+  "star_5_point_rounded"
+]

addedInput schema / properties / input / properties / name

Added value: +{
+  "default": null,
+  "description": "Custom QR code name",
+  "type": "string"
+}

addedInput schema / properties / input / properties / network_type

Added value: +{
+  "default": null,
+  "description": "Security type: WPA (most home networks), WEP or nopass.",
+  "type": "string"
+}

addedInput schema / properties / input / properties / note

Added value: +{
+  "default": null,
+  "description": "Note for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / number

Added value: +{
+  "default": null,
+  "description": "Phone number (without calling code) for 'WHATSAPP' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / organization

Added value: +{
+  "default": null,
+  "description": "Organization for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / postcode

Added value: +{
+  "default": null,
+  "description": "Postcode for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / resolution

Added value: +{
+  "default": null,
+  "description": "Output resolution in DPI",
+  "enum": [
+    72,
+    150,
+    300,
+    600
+  ],
+  "type": "integer"
+}

changedInput schema / properties / input / properties / size / description

Previous value: -"Output image size in pixels"New value: +"Output image size in pixels (75-3000)"

addedInput schema / properties / input / properties / ssid

Added value: +{
+  "default": null,
+  "description": "Network SSID for 'WIFI' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / start_date_time

Added value: +{
+  "default": null,
+  "description": "Event start, ISO 8601 with offset, for example 2026-12-01T18:00:00+00:00. Ask the user for the time zone if unclear.",
+  "type": "string"
+}

addedInput schema / properties / input / properties / state

Added value: +{
+  "default": null,
+  "description": "State for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / street

Added value: +{
+  "default": null,
+  "description": "Street for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / telephone_number

Added value: +{
+  "default": null,
+  "description": "Work phone for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / type / enum

Added value: +[
+  "APP_DOWNLOAD",
+  "AR_QR_CODE",
+  "ATTENDANCE",
+  "AUDIO",
+  "BATCH",
+  "BITCOIN",
+  "COUPON",
+  "DETAIL_PAGE",
+  "DIGITAL_BUSINESS_CARD",
+  "DISCORD",
+  "DROPBOX",
+  "EVENTBRITE",
+  "FACEBOOK",
+  "FACEBOOK_LIKE",
+  "FILE_UPLOAD",
+  "FORM_SUBMISSION",
+  "GOOGLE_FORM",
+  "GOOGLE_REVIEW",
+  "GOOGLE_MEET",
+  "IMAGE",
+  "INSTAGRAM",
+  "ITUNES_LINK",
+  "LINKEDIN",
+  "LINKEDIN_SHARE",
+  "MAILTO",
+  "MAPS",
+  "MATMSG",
+  "MULTI_PDF",
+  "NEWSLETTER",
+  "MENUMAKER",
+  "LAUNCHPAD",
+  "PAYPAL_BUY",
+  "PDF",
+  "SKYPE",
+  "SMSTO",
+  "SOCIAL_LINKS",
+  "SNAPCHAT",
+  "SPOTIFY",
+  "TELEGRAM",
+  "TEL",
+  "TEXT",
+  "TILEZ_DBC",
+  "TIKTOK",
+  "UPI",
+  "URL",
+  "CALENDLY",
+  "VCALENDAR",
+  "VCARD",
+  "VENMO",
+  "VIDEO",
+  "VIMEO",
+  "WHATSAPP",
+  "WIFI",
+  "TWITTER",
+  "TWITTER_STATUS",
+  "YOUTUBE",
+  "ZELLE",
+  "ZOOM",
+  "DPP_GS1"
+]

addedInput schema / properties / input / properties / url_key

Added value: +{
+  "default": null,
+  "description": "Custom short URL slug (dynamic QR codes only, plan permitting)",
+  "type": "string"
+}

addedInput schema / properties / input / properties / vcard_title

Added value: +{
+  "default": null,
+  "description": "Job title / honorific for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / vcard_type

Added value: +{
+  "default": null,
+  "description": "VCARD encoding sub-format: 'vcard' (default) or 'mecard'",
+  "enum": [
+    "vcard",
+    "mecard"
+  ],
+  "type": "string"
+}

addedInput schema / properties / input / properties / vcard_url

Added value: +{
+  "default": null,
+  "description": "Website URL for 'VCARD' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / wallet_address

Added value: +{
+  "default": null,
+  "description": "Wallet address for 'BITCOIN' type",
+  "type": "string"
+}

addedInput schema / properties / input / properties / wifi_password

Added value: +{
+  "default": null,
+  "description": "Wi-Fi password. Include only if the user gave it. Leave empty for open networks.",
+  "type": "string"
+}

addedInput schema / properties / input / properties / wifi_visibility

Added value: +{
+  "default": null,
+  "description": "True if the 'WIFI' network SSID is hidden",
+  "type": "boolean"
+}

First observedOct 12, 2026

TDQS

A4.9/5.0

Behavior5/5

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

Annotations declare destructiveHint=true, but the description goes beyond them by stating the concrete consequence: the call 'overwrites the saved settings', so an unstale full merge is mandatory. It also surfaces the static-code immutability constraint, which the annotations cannot express. This is exactly the kind of behavioral warning that prevents data loss.

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

Conciseness5/5

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

Three sentences, front-loaded with the trigger condition ('Use this when...'), followed by the critical prerequisite and then the exclusions. No sentence is redundant or restates the tool name.

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?

For a destructive, idempotent mutation with a rich 100%-covered schema and no output schema, the description supplies everything an agent needs: when to use, the required read-then-merge workflow, the overwrite risk, and the sibling routing. Nothing material is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline expectation is already met by structured fields. The description still adds operational meaning by requiring the 'full merged settings' rather than a partial patch, which changes how every optional property must be supplied. It stops short of explaining parameter specifics, but the schema already carries that load.

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 ('change a QR code already in their account') and enumerates the scopes covered (destination/content/appearance). It explicitly distinguishes itself from generate_qr_code, so an agent can tell the two apart without opening either 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?

Names the prerequisite workflow ('Call get_qr_code_by_id first and send the full merged settings'), states a hard limitation ('a static code that is already printed cannot change what it encodes'), and gives an explicit exclusion with the alternative ('Do not use it to make a new code (use generate_qr_code)'). This is a near-complete routing instruction.

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

All QRStuff MCP Server tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?