QRStuff MCP Server

Generate QR code

generate_qr_code

Use this when the signed-in user wants a QR code saved to their QRStuff account: one they can edit later (dynamic), track scans on, style with colours, shapes, a logo or frame, or that opens a file, event, vCard, Wi-Fi, payment, app download, social links or any of 50+ other types. Creates and saves the code (output_type download shows it in the dashboard; preview saves it as a hidden draft for trying designs) and returns the image and download link. Set dynamic false for a code that never needs changing. Do not use it to change an existing code (use update_qr_code), to shorten a link (use create_short_link), or for a quick one-off code when the user is not signed in (use create_static_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": "generate_qr_code"
  }
}

Input Schema

Name	Required	Description	Default
`input`	Yes	The QR code to create: what it opens or stores, plus optional styling and settings.
`output_type`	No	Optional override for input.output_type. Use 'preview' or 'download'. Case-insensitive; unknown values become 'download'.

Schema Changelog

Changes observed during successful MCP inspections.

Changed62 schema fields changedOct 30, 2026

addedInput schema / properties / input / description

Added value: +"The QR code to create: what it opens or stores, plus optional styling and settings."

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"
+  }
+]

addedInput schema / properties / input / properties / data / default
```
Added value: +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."
+}

changedInput schema / properties / input / properties / dynamic / description

Previous value: -"Generate dynamic QR when true, static when false"New value: +"true (default) makes a code you can edit and track after printing; false makes a fixed code that never changes and keeps no scan counts. Use false when the user says they will print it once and not change it."

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"
+}

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 / output_type

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "preview",
+        "download"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": "download",
+  "description": "download (default): save the code and show it in the user's dashboard. preview: save it as a hidden draft while the user compares designs. Both save a code."
+}

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"
+}

changedInput schema / properties / input / properties / type / description

Previous value: -"QR data type, e.g., 'URL', 'TEXT', 'MAILTO', 'TEL', or 'SMSTO'"New value: +"What the code opens or stores when scanned. Use URL for a web link, WIFI for a Wi-Fi network, VCARD for a contact, LAUNCHPAD for a landing page, PDF for a document. Call `list_qr_data_types` for a type you are unsure of."

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"
+}

removedInput schema / properties / input / required
```
Removed value: -[
-  "data"
-]
```

addedInput schema / properties / output_type

Added value: +{
+  "anyOf": [
+    {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional override for input.output_type. Use 'preview' or 'download'. Case-insensitive; unknown values become 'download'."
+}

First observedOct 12, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations only declare the generic write profile (readOnlyHint=false, destructiveHint=false, openWorldHint=true, idempotentHint=false). Beyond that, the description discloses that both output types persist a code, that `preview` creates a hidden draft, and that `dynamic` false permanently forfeits editability and scan counts — real side-effect information not in the annotations. It stops short of stating auth/plan requirements or rate limits, which would be needed for a 5.

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?

The routing information (what it does, key behaviour, exclusions) is front-loaded in a single well-built paragraph, and every clause carries signal. It is dense but slightly overpacked — the long capability enumeration (50+ types, styling options) could be trimmed since the enum already lists them.

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 complex, deeply nested creation tool with no output schema, the description covers what is produced (saved code, image and download link), the persistence semantics of both output modes, and how it relates to sibling tools. Combined with 100% schema coverage, an agent has what it needs to call this correctly.

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 the schema already documents every parameter including the nested colours, data_fields and advanced_settings objects; the baseline is 3. The description does add interpretive value for `output_type` and `dynamic`, but most of its phrasing mirrors the schema text rather than adding new semantics.

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 (generate/create and save) and resource (QR code in the user's QRStuff account), then enumerates the distinguishing capability set (dynamic editing, scan tracking, styling, 50+ data types). It names the sibling tools it is not (update_qr_code, create_short_link, create_static_qr_code), so an agent can separate it from near neighbours without opening a 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?

Explicitly says when to use it (signed-in user wants a saved, editable/trackable/styled code), and gives three concrete when-not-to-use cases each with the correct alternative tool. It also clarifies the output_type variants and the `dynamic` false case, leaving little to inference.

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?