The QRX MCP server lets AI assistants make artistic QR codes for you: describe a picture and give a link, and the assistant starts the code, waits while it is painted and hands back the image and its short link. It works with Claude, ChatGPT, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex, Gemini CLI and other clients that speak the Model Context Protocol.
https://qrx.codes/mcpAdd the server URL to your client and sign in to QRX when it asks (it’s free), then approve access. There is nothing to copy or keep secret. For scripts, CI and clients that can’t sign in, use an API key instead: make one on the API keys page and send it as Authorization: Bearer <your API key>, or as X-API-Key: <your API key> from a client that can only add a plain header. Give each assistant its own key, so you can see its usage and revoke it on its own.
QRX, give the server URL, https://qrx.codes/mcp, and sign in to QRX when Claude asks.Authorization with the value Bearer <your API key>./mcp, select qrx and sign in.claude -p or in CI), put the key in the QRX_API_KEY environment variable and add the --header line. It saves the server to .mcp.json with a reference to the variable, not the key, so the file is safe to commit.claude mcp add --transport http --scope user qrx https://qrx.codes/mcpQRX, give the server URL, https://qrx.codes/mcp, and choose OAuth. Accept the warning and select Create as a plugin..cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project, and sign in to QRX when Cursor asks.QRX_API_KEY environment variable.{
"mcpServers": {
"qrx": {
"url": "https://qrx.codes/mcp"
}
}
}.vscode/mcp.json and sign in to QRX when VS Code asks.{
"servers": {
"qrx": {
"type": "http",
"url": "https://qrx.codes/mcp"
}
}
}~/.codeium/windsurf/mcp_config.json (Devin Desktop: ~/.config/devin/mcp_config.json) and sign in to QRX when Windsurf asks. Note serverUrl, not url.QRX_API_KEY environment variable.{
"mcpServers": {
"qrx": {
"serverUrl": "https://qrx.codes/mcp"
}
}
}cline_mcp_settings.json and sign in to QRX when Cline asks. autoApprove lists the tools that only read.<your API key>.{
"mcpServers": {
"qrx": {
"type": "streamableHttp",
"url": "https://qrx.codes/mcp",
"disabled": false,
"autoApprove": [
"get_qr_code",
"list_qr_codes",
"get_account",
"get_profile",
"list_styles"
]
}
}
}codex mcp login qrx signs in again later.bearer_token_env_var = "QRX_API_KEY" to the [mcp_servers.qrx] entry in ~/.codex/config.toml.codex mcp add qrx --url https://qrx.codes/mcp/mcp auth qrx.--header "Authorization: Bearer $QRX_API_KEY" to the command.gemini mcp add --transport http -s user qrx https://qrx.codes/mcpAny other client, such as Zed, Goose, LM Studio or Kiro: add https://qrx.codes/mcp as a Streamable HTTP server and sign in when it asks, or send the same header with your API key. A client that only runs local (stdio) servers can run npx -y @qrxcodes/mcp, which forwards to the same server with your key from QRX_API_KEY:
{
"mcpServers": {
"qrx": {
"command": "npx",
"args": [
"-y",
"@qrxcodes/mcp"
],
"env": {
"QRX_API_KEY": "<your API key>"
}
}
}
}| Tool | What it does | Reads or writes |
|---|---|---|
generate_qr_codeGenerate a QR code · Writes | Starts a new code from a description of the picture and the link it opens. It answers at once with the code’s id while the picture is painted. | Writes |
generate_qr_code_from_imageGenerate a QR code from an image · Writes | Starts a new code woven into a picture you already have, attached in the chat, as a link or as base64, instead of a description. Every picture is checked for safety first; one that does not pass is refused and nothing is made. | Writes |
vary_qr_codeMake a variation of a QR code · Writes | Starts a new code from one of your codes with a change to its picture, such as “more trees”. The new code has its own short link to the same destination; the original does not change. | Writes |
get_qr_codeGet a QR code · Reads | A code’s status, image and short link. While the code is still being painted it waits up to 25 seconds for it. | Reads |
list_qr_codesList QR codes · Reads | The codes on your account, newest first, a page at a time. | Reads |
change_qr_code_destinationChange where a QR code points · Writes | Points an existing link code at a new web address. Printed copies follow at once, so assistants ask before using it. | Writes |
get_accountGet plan and usage · Reads | How many codes are left today, when the count resets, and what the account can do. | Reads |
get_profileGet the signed-in QRX account · Reads | Which QRX account is connected. | Reads |
list_stylesList QR code styles · Reads | The looks a new code can be painted in. | Reads |
Every tool says whether it only reads, so clients can run the reading tools without asking each time. In clients that show interactive views, such as Claude, a new code appears in a card that fills in when it is ready.
get_account says how many are left and when the count resets.get_qr_code waits up to 25 seconds at a time, and the assistant calls it again until the code is ready.AGENTS.md snippet.https://qrx.codes/v1.