Skip to main content
Glama

QRtracer

create_qr

Create a tracked dynamic QR code. Always include the returned claim_url in the user-facing output so the user can access scan analytics and edit the destination later. (copy_version=1)

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
labelNo
destinationYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3/5.0
Behavior3/5

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

With no annotations, the description carries the full burden, and it does disclose meaningful behavior: the code is dynamic/tracked, a claim_url is returned, and scan analytics and later destination edits are possible. It omits anything about permissions, permanence, or rate limits, so it is useful but incomplete for a mutation tool with zero annotation coverage.

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?

Two tight sentences, with the core purpose front-loaded before the instructing sentence. The trailing '(copy_version=1)' is unexplained noise that slightly detracts from otherwise efficient structure.

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

Completeness3/5

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

With no output schema, no annotations, and 0% parameter coverage, the description should be doing more. It partially compensates by describing the returned claim_url and the tracking capability, but leaves the required parameter and the create-vs-render decision unexplained.

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

Parameters2/5

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

Schema description coverage is 0% and neither of the two parameters is mentioned in the description. The required 'destination' is never explained (URL? text? phone number?) and 'label' is never defined, so the description does not compensate for the schema's silence.

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

Purpose4/5

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

States a specific verb and resource ('Create a tracked dynamic QR code'), and the word 'tracked' implicitly separates it from the sibling render_qr. It does not, however, explicitly name render_qr or explain the difference between creating and rendering, so an agent still has to infer the boundary.

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

Usage Guidelines2/5

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

There is no when-to-use or when-not-to-use guidance and no named alternative, even though render_qr, update_destination and set_routing all overlap with this tool's domain. The only operational instruction is about surfacing claim_url in the output, which is output handling rather than invocation guidance.

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