QRX: art QR codes that always scan

QRX turns a short picture description (the prompt) and a destination link into an artistic QR code. Every code is checked to decode before it is returned, and it encodes a hosted short link, https://qrx.to/<id> on qrx.codes, which forwards scans to the destination. Treat the result as a design asset: a PNG the user can drop into print or digital layouts.

When to Use

Use it when the user wants a QR code that is also a picture: on-brand, decorative, or eye-catching enough to earn a scan. Typical asks: a café menu code in a watercolour style, a conference badge code in the event's colours, a poster code that blends into the artwork, a product-packaging code, a wedding-invitation code.

Do not use it when:

• a plain, unstyled QR code will do and can be made locally (offer QRX only if the user wants something designed);
• the user wants to change the art of an existing code (make a new code instead);
• the request is for a logo, trademark or character the user does not own (see "What not to do").

Tools (QRX MCP server)

The server needs the user to sign in to QRX (or an API key) before it connects. If the tools are missing, it is not connected: ask the user to sign in from their client's MCP or connector settings, or use the REST API instead (see references/rest-api.md).

How to make a code

1. Get the destination. It must be an absolute URL starting with https:// or http:// (add https:// if the user gave a bare domain, and confirm the exact link if it is ambiguous). The MCP tools make link codes only; for a Wi-Fi code, send the user to https://qrx.codes, and never ask them for a Wi-Fi password.
2. Write the prompt (see "Writing a good prompt"). If the user named a look, call list_styles and pick the closest style id; otherwise leave style out.
3. Call generate_qr_code once. Keep the returned id; it never changes. Painting usually takes under a minute.
4. Poll with get_qr_code using that id until status is succeeded or failed. Each call waits up to 25 seconds, so two or three calls are normal.
   • Never call generate_qr_code again while a code is still processing: every generate counts against the user's allowance.
5. Show the result: the image (imageUrl, a PNG), the short link the code encodes (shortUrl, https://qrx.to/<id> on qrx.codes), the destination, and the code's page (pageUrl). Tell the user to test-scan it with a phone before printing.
6. On failed: read error.message, simplify the prompt (fewer elements, more contrast), and offer one retry. Ask before making more than one extra attempt.

For several variations, say how many will be made and that each counts against the allowance, then start them and poll each id.

Writing a good prompt

The prompt describes the picture only. QRX handles the QR pattern itself.

• Lead with one clear subject and setting: "a lighthouse on a cliff at sunset", "a bowl of ramen with steam rising", "a eucalyptus branch with gumnuts".
• Add a style or medium: watercolour, linocut print, isometric 3D, art deco poster, Japanese woodblock, papercraft, neon line art.
• Name the palette, especially brand colours: "in deep navy, coral and cream"; describe colours in words, since hex codes are not reliably followed.

…