OpenQR — Claude Code MCP server: what it does, how to install
Generates static and editable dynamic QR codes, customizes styling, and collects scan analytics directly inside AI coding assistants.
claude mcp add qr -e OPENQR_API_KEY=<OPENQR_API_KEY> -- npx -y @open-qr/mcpWhat OpenQR does
The MCP server connects coding clients to https://openqr.uk/mcp. It lets your assistant render static codes in PNG or SVG markup. It also handles dynamic codes whose destination URL updates later without reprinting. Batch generation creates up to 200 codes at once.
Organization tools include folders, tags, and reusable visual themes. You can pick colors along with dot and corner styles. Pre-built styles arrive as MCP resources, and four bundled prompts handle tasks like scan reports.
Calls will fail without an API key. Every tool requires credentials passed through the authorization header or the OPENQR_API_KEY variable.
What it helps with
- render vector SVG QR codes from URLs or plain text
- set up editable dynamic QR codes before printing
- fetch scan analytics and country metrics
- batch create up to 200 dynamic codes with custom tags
Example prompts for the agent
- Generate an SVG QR code pointing to my project repository
- Create an editable dynamic QR code for our new landing page
- Show the scan statistics for my dynamic QR codes
How to install OpenQR
1Platform CLI
claude mcp add qr -e OPENQR_API_KEY=<OPENQR_API_KEY> -- npx -y @open-qr/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http openqr https://openqr.uk/mcp1Platform CLI: remote server
codex mcp add openqr --url https://openqr.uk/mcp2Platform CLI
codex mcp add openqr --env OPENQR_API_KEY=<OPENQR_API_KEY> -- npx -y @open-qr/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"openqr": {
"url": "https://openqr.uk/mcp"
}
}
}{
"mcpServers": {
"openqr": {
"command": "npx",
"args": [
"-y",
"@open-qr/mcp"
],
"env": {
"OPENQR_API_KEY": "<OPENQR_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"openqr": {
"type": "http",
"url": "https://openqr.uk/mcp"
}
}
}{
"servers": {
"openqr": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@open-qr/mcp"
],
"env": {
"OPENQR_API_KEY": "<OPENQR_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http openqr https://openqr.uk/mcp2Platform CLI
gemini mcp add -e OPENQR_API_KEY=<OPENQR_API_KEY> openqr npx -y @open-qr/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenQR
How to install OpenQR in Claude Code?
To connect OpenQR via HTTP, run claude mcp add --transport http openqr https://openqr.uk/mcp. If you run it locally through stdio, use claude mcp add --env OPENQR_API_KEY=<OPENQR_API_KEY> --transport stdio openqr -- npx -y @open-qr/mcp.
What does OpenQR do?
It provides tools to generate static QR codes, configure editable dynamic destinations, read scan counts, and manage design presets.
Is an API key required to use the tools?
Yes, every tool requires a key from https://openqr.uk/api. You provide it via the authorization header or the OPENQR_API_KEY environment variable.
