# QRX

Generates stylized, scan-tested QR codes from prompts and URLs. Returns print-ready graphics paired with hosted short links.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3
- Author: qrxcodes
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qrxcodes/qrx-mcp
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/qrx

## What it does

QRX turns text prompts and target URLs into stylized QR codes for signage or packaging. The remote service renders the artwork and verifies that scanners decode the image before returning it. Each design routes through a hosted short URL at `https://qrx.to/<id>`.

The tools let the agent pull past generations and monitor remaining daily allowances. Paid plans allow redirecting an existing printed code to another link without a reprint.

Requests require OAuth sign-in or a secret key stored in `QRX_API_KEY`. Without credentials, the endpoint immediately returns HTTP 401.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://qrx.codes/mcp`
- Environment variables: `QRX_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://qrx.codes/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env QRX_API_KEY=<QRX_API_KEY> --transport stdio qrx -- npx -y @qrxcodes/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add qrx --url https://qrx.codes/mcp
```

2. **Platform CLI**
```bash
codex mcp add qrx --env QRX_API_KEY=<QRX_API_KEY> -- npx -y @qrxcodes/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "qrx": {
            "url": "https://qrx.codes/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "qrx": {
            "command": "npx",
            "args": [
                "-y",
                "@qrxcodes/mcp"
            ],
            "env": {
                "QRX_API_KEY": "<QRX_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "qrx": {
            "type": "http",
            "url": "https://qrx.codes/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "qrx": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@qrxcodes/mcp"
            ],
            "env": {
                "QRX_API_KEY": "<QRX_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http qrx https://qrx.codes/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e QRX_API_KEY=<QRX_API_KEY> qrx npx -y @qrxcodes/mcp
```
Replace <…> with your own values

## When to use it
- generate art-styled QR codes for signage and packaging
- verify code readability before sending files to print
- update destination URLs on existing codes without reprinting
- track remaining generation balance for the current day

## Example prompts
- Generate a QR code for `https://example.com/menu` styled as a watercolour café street.
- Show the most recent QR codes created on my account.
- Check my remaining generation balance for today.

## Similar
- [Next AI Draw.io](https://affpapa.org/en/nevibecode/mcp/next-ai-drawio.md) — MCP server · ★ 36427
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51104
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16073
- [Agent-Native Assets](https://affpapa.org/en/nevibecode/mcp/agent-native-assets.md) — MCP server · ★ 7527
- [Remove AI Watermarks](https://affpapa.org/en/nevibecode/mcp/remove-ai-watermarks.md) — MCP server · ★ 6144
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3851

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md