MCP Server

qr3.app ships with a full Model Context Protocol (MCP) server. AI agents like Claude, Cursor, and any MCP-capable client can create, update, and analyze QR codes without writing a single line of code.

Setup

Get your API key from app.qr3.app → Settings → API Keys
Add the MCP server to your client config
The agent now has access to all qr3 tools

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "qr3": {
      "command": "npx",
      "args": ["-y", "@qr3/mcp-server"],
      "env": {
        "QR3_API_KEY": "qr3_sk_your_key_here",
        "QR3_WORKSPACE_ID": "ws_your_workspace_id"
      }
    }
  }
}

Edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "qr3": {
      "command": "npx",
      "args": ["-y", "@qr3/mcp-server"],
      "env": {
        "QR3_API_KEY": "qr3_sk_your_key_here"
      }
    }
  }
}

QR3_API_KEY=qr3_sk_... npx @qr3/mcp-server

Available tools

Core tools (all plans)

Tool	Description
`create_qr`	Create a QR code for a URL, vCard, WiFi, or other types
`list_qr_codes`	List QR codes with filtering and pagination
`get_qr_code`	Get details and analytics for a specific QR code
`update_qr_code`	Update destination URL, status, or tags
`delete_qr_code`	Delete a QR code
`get_scan_stats`	Get scan analytics (country, device, timeline)
`create_batch`	Create up to 100 QR codes at once
`list_workspaces`	List available workspaces

Premium tools (AI Power Pack — Agency plan)

Tool	Description
`analyze_qr_performance`	AI-powered performance analysis with recommendations
`create_dpp_qr`	Create EU Digital Product Passport QR codes
`bulk_create_advanced`	Batch creation with A/B testing and expiry
`manage_workspace`	Workspace settings and member management
`get_audit_trail`	Full audit log for compliance
`validate_dpp`	Validate DPP data against EU specification

Example conversations

User: Create a QR code for https://example.com that expires in 30 days

Claude: I'll create a dynamic QR code with a 30-day expiry for you.

[calls create_qr with url, is_dynamic=true, expires_at=+30days]

Created! Short code: r7f3Kx
- SVG: https://qr3.app/v1/codes/r7f3Kx/qr.svg
- Expires: April 14, 2026

User: How many times was my homepage QR scanned this month?

Claude: Let me check the analytics for you.

[calls list_qr_codes, then get_scan_stats for the matching code]

Your homepage QR was scanned 142 times this month:
- Top country: Austria (45 scans)
- Top device: Mobile (89%)
- Peak day: Monday

Environment variables

Variable	Required	Description
`QR3_API_KEY`	✅	Your qr3.app API key (`qr3_sk_...`)
`QR3_WORKSPACE_ID`	⚠️	Workspace ID (required if account has multiple workspaces)
`QR3_BASE_URL`	❌	Override API base URL (default: `https://qr3.app`)