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, ChatGPT, Cursor, VS Code and other MCP clients through the remote server at https://qrx.codes/mcp.

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

_{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

Sign in or use an API key

Every client below that takes a URL signs in with your QRX account: add the URL, then sign in (free) when the client asks as it connects. There is nothing to copy or keep secret.

For clients that only run local servers, and for scripts and CI, use an API key. Any client below can use one instead of signing in:

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:

   bashCopy

   # macOS / Linux
   export QRX_API_KEY="qrx_live_…"
   

   powershellCopy

   # 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 --scope user

{
  "mcpServers": {
    "qrx": {
      "type": "http",
      "url": "https://qrx.codes/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "qrx": {
      "url": "https://qrx.codes/mcp"
    }
  }
}

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

{
  "servers": {
    "qrx": {
      "type": "http",
      "url": "https://qrx.codes/mcp"
    }
  }
}

code --add-mcp '{"name":"qrx","type":"http","url":"https://qrx.codes/mcp"}'

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

{
  "mcpServers": {
    "qrx": {
      "serverUrl": "https://qrx.codes/mcp"
    }
  }
}

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

{
  "context_servers": {
    "qrx": {
      "url": "https://qrx.codes/mcp"
    }
  }
}

extensions:
  qrx:
    name: qrx
    type: streamable_http
    enabled: true
    uri: https://qrx.codes/mcp
    timeout: 300

codex mcp add qrx --url https://qrx.codes/mcp

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

gemini mcp add --transport http -s user qrx https://qrx.codes/mcp

{
  "mcpServers": {
    "qrx": {
      "httpUrl": "https://qrx.codes/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "qrx": {
      "url": "https://qrx.codes/mcp"
    }
  }
}

npx skills add qrxcodes/qrx-mcp

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

{
  "mcpServers": {
    "qrx": {
      "command": "npx",
      "args": ["-y", "@qrxcodes/mcp"],
      "env": { "QRX_API_KEY": "qrx_live_…" }
    }
  }
}

Tools

Connecting needs sign-in or an API key. The tool list is public at https://qrx.codes/.well-known/mcp/server-card.json.

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

Connecting to https://qrx.codes/mcp needs sign-in or an API key; without one the server answers 401. 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 sign-in token or API key and the prompt, destination link and style you asked for. Signing in goes through QRX's sign-in service at https://clerk.qrx.codes. 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 hello@qrx.codes
• 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.