QRX

QRX

Art QR codes that always scan.

QRX makes branded, print-ready QR codes for posters, menus, packaging and signage. Describe the look you want and give it a link: QRX paints the code into artwork, checks that it decodes before handing it over, and points it at a hosted short link, https://qrx.to/<id> on qrx.codes, that you can re-point later on the Starter plan. This repository connects QRX to Claude, Cursor, VS Code and other MCP clients (ChatGPT once sign-in ships) through the remote server at https://qrx.codes/mcp.

[Install in VS Code] [Install in Cursor] [Glama] [Licence: MIT]

Listed in the official MCP Registry as codes.qrx/mcp.

[A QR code painted as a watercolour river with pine trees, made by QRX]

_{The QRX logo is a QRX code. Point your phone at it.}

What you can do

• Make a code: "Make a QR code for https://example.com/menu that looks like a watercolour café street."
• Check on it: generation usually takes under a minute; the agent waits for it and returns the image and short link.
• Find old codes: list the codes on your account, newest first.
• Re-point a code: send an existing printed code to a new link, with no reprint (Starter plan).
• Check your allowance: see how many codes you have left today.

Connection details

Get an API key

1. Sign in at qrx.codes (free).

2. Open qrx.codes/developers/keys and create a key. It starts with qrx_.

3. Keep it secret. The examples below read it from an environment variable called QRX_API_KEY wherever the client allows that:

   bash

   # macOS / Linuxexport QRX_API_KEY="qrx_live_…"

   powershell

   # Windows PowerShell (current user, persistent)[Environment]::SetEnvironmentVariable("QRX_API_KEY", "qrx_live_…", "User")

Revoke a key at any time from the same page.

Install

/plugin marketplace add qrxcodes/qrx-mcp/plugin install qrx@qrx

claude mcp add --transport http qrx https://qrx.codes/mcp \  --header "Authorization: Bearer $QRX_API_KEY" --scope user

{  "mcpServers": {    "qrx": {      "type": "http",      "url": "https://qrx.codes/mcp",      "headers": { "Authorization": "Bearer ${QRX_API_KEY}" }    }  }}

{  "mcpServers": {    "qrx": {      "url": "https://qrx.codes/mcp",      "headers": { "Authorization": "Bearer ${env:QRX_API_KEY}" }    }  }}

{  "inputs": [    {      "type": "promptString",      "id": "qrx-api-key",      "description": "QRX API key (starts with qrx_)",      "password": true    }  ],  "servers": {    "qrx": {      "type": "http",      "url": "https://qrx.codes/mcp",      "headers": { "Authorization": "Bearer ${input:qrx-api-key}" }    }  }}

code --add-mcp '{"name":"qrx","type":"http","url":"https://qrx.codes/mcp","headers":{"Authorization":"Bearer ${input:qrx-api-key}"},"inputs":[{"type":"promptString","id":"qrx-api-key","description":"QRX API key","password":true}]}'

{  "mcpServers": {    "qrx": {      "serverUrl": "https://qrx.codes/mcp",      "headers": { "Authorization": "Bearer ${env:QRX_API_KEY}" }    }  }}

{  "mcpServers": {    "qrx": {      "type": "streamableHttp",      "url": "https://qrx.codes/mcp",      "headers": { "Authorization": "Bearer qrx_live_…" },      "disabled": false,      "autoApprove": ["list_styles", "get_qr_code", "list_qr_codes", "get_account", "get_profile"]    }  }}

{  "context_servers": {    "qrx": {      "url": "https://qrx.codes/mcp",      "headers": { "Authorization": "Bearer qrx_live_…" }    }  }}

extensions:  qrx:    name: qrx    type: streamable_http    enabled: true    uri: https://qrx.codes/mcp    headers:      Authorization: "Bearer qrx_live_…"    timeout: 300

[mcp_servers.qrx]url = "https://qrx.codes/mcp"bearer_token_env_var = "QRX_API_KEY"

gemini mcp add --transport http --header "Authorization: Bearer $QRX_API_KEY" qrx https://qrx.codes/mcp

{  "mcpServers": {    "qrx": {      "httpUrl": "https://qrx.codes/mcp",      "headers": { "Authorization": "Bearer $QRX_API_KEY" }    }  }}

npx skills add qrxcodes/qrx-mcp

gemini extensions install https://github.com/qrxcodes/qrx-mcp

{  "mcpServers": {    "qrx": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://qrx.codes/mcp", "--header", "Authorization:Bearer ${QRX_API_KEY}"],      "env": { "QRX_API_KEY": "qrx_live_…" }    }  }}

Tools

In clients that show interactive views (MCP Apps), such as Claude, the code also appears in a card that fills in when it is ready.

Example prompts

1. "Make a QR code for https://example.com/menu that looks like a watercolour street of cafés."
2. "Design a QR code for our wedding RSVP page, https://example.com/rsvp, as eucalyptus leaves and gold foil on cream paper."
3. "I need a QR code for a gig poster that opens https://example.com/tickets. Neon synthwave city at night."
4. "Show me the styles QRX has, then make a code for https://example.com in the one that best suits a bakery."
5. "List my QR codes from this week and give me the short links."
6. "The flyer code we printed last month should now open https://example.com/spring-sale instead."
7. "How many QR codes can I still make today?"
8. "Make three variations of a QR code for https://example.com/shop with a Japanese woodblock wave, and tell me which scans are verified."

How generation works

• generate_qr_code returns within a few seconds with an id and status: processing. The artwork usually takes under a minute on a GPU.
• get_qr_code then waits for up to 25 seconds per call (wait, 0–25). Agents call it again until the status is succeeded (or failed). In MCP Apps clients the card fills in with the image when it's ready.
• A finished code includes the image URL, the short link it encodes (shortUrl: https://qrx.to/<id> on qrx.codes) and the destination it redirects to. Every code is decoded before it's marked succeeded. A code's id and short link never change.
• Each code you start counts against your plan, even if you don't keep the result.

Plans and limits

The API, the MCP server and the website share one allowance. Each key is also rate limited (30 requests a minute and 6 new codes per 10 seconds). If you hit a limit the tool returns an error; get_account shows what is left and when the daily count resets. Plans: https://qrx.codes/upgrade. Limits: qrx.codes/developers.

What this repository contains

None of these files run code on your machine. They only point your client at https://qrx.codes/mcp.

Data and network use

Clients send requests only to https://qrx.codes/mcp (and, when the skill falls back to the REST API, to https://qrx.codes/v1). Each request carries your API key and the prompt, destination link and style you asked for. A finished code's imageUrl is on https://qrx.codes/media/, which redirects to QRX's image CDN.

Privacy, terms and support

• Privacy: https://qrx.codes/privacy
• Terms: https://qrx.codes/terms
• Support: https://qrx.codes/developers or [email protected]
• API docs: qrx.codes/developers; MCP server: qrx.codes/developers/mcp; for agents: llms.txt and the OpenAPI document. No key needed to read them.

QRX stores the prompts, links and images you create so they appear in your account. It doesn't read your chat history; it only sees the arguments the client sends to its tools.

Licence

The configuration files, skill and documentation in this repository are released under the MIT licence. The QRX service itself is a hosted product, governed by the QRX terms.