Quality QR

Quality QR lets agents create, manage, and track QR codes — saved to the user's account with scan analytics and dynamic URL updates. No local installation: the MCP server runs at https://quality-qr.app/api/mcp.

Quick Setup

One command connects Claude Code to the MCP server:

claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Replace YOUR_API_KEY with a key starting with qr_live_. If you don't have one yet, see Path C below.

After setup, verify it works:

quality_qr_list

If you get back a list (even an empty one), you're connected.

Choose Your Path

• Need to create or manage QR codes now → Path A (MCP tools)
• Building an app that calls the QR API from code → Path B (REST API)
• Need an API key first → Path C (account setup)

Path A: Use the MCP Tools

Use this when you are an AI agent with MCP support (Claude Desktop, Cursor, Claude Code, etc.) and need to create, update, or analyze QR codes during this session.

Available tools

QR code types

Dynamic (destination can be changed after printing): URL, PDF, Menu, App Store, Social

Static (data encoded directly in the code): WiFi, vCard, Email, Phone, SMS, Text, Event

Default workflow

1. Use quality_qr_create with a type and content or data object.
2. The response includes an inline SVG — present it to the user.
3. For dynamic codes, use quality_qr_update to change the destination later.
4. Use quality_qr_analytics to check scan performance.

Example prompts

• "Create a QR code for https://example.com"
• "Make a WiFi QR code for network MyWiFi with password guest123"
• "Show me analytics for my QR codes"
• "List all my QR codes"
• "Disable QR code abc123"

If the task becomes "build an app that generates QR codes," switch to Path B.

Path B: Use the REST API

Use this when you're a coding agent building an application, workflow, or service that calls the Quality QR API from code.

Base URL

https://quality-qr.app/api/v1

Authentication

Authorization: Bearer qr_live_YOUR_KEY

Create a QR code

curl -X POST https://quality-qr.app/api/v1/qr \
  -H "Authorization: Bearer qr_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "content": "https://example.com",
    "name": "My Website",
    "isDynamic": true
  }'

Response:

{
  "success": true,
  "type": "url",
  "dataUrl": "data:image/png;base64,...",
  "qrCode": {
    "id": "abc123",
    "name": "My Website",
    "shortCode": "xY7kL9mN",
    "shortUrl": "https://quality-qr.app/q/xY7kL9mN"
  }
}

List QR codes

curl https://quality-qr.app/api/v1/qr \
  -H "Authorization: Bearer qr_live_YOUR_KEY"

Supported types and required fields

Design options

{
  "type": "url",
  "content": "https://example.com",
  "design": {
    "foregroundColor": "#1a56db",
    "backgroundColor": "#ffffff"
  }
}

Error responses

If you don't have a key yet, do Path C first.

Path C: Get an API Key

Use this when the human doesn't have an API key yet, or needs to create an account.

If you already have a valid qr_live_ key, skip this path.

Step 1 — Ask the human to sign up or sign in:

https://quality-qr.app

Free accounts require no credit card.

Step 2 — Generate an API key:

Direct the human to:

https://quality-qr.app/dashboard/api-keys

They click Create New Key, copy the value (starts with qr_live_).

Step 3 — Save the key and continue:

For MCP setup, go back to Quick Setup above. For app integration, set:

echo "QUALITY_QR_API_KEY=qr_live_..." >> .env

Rate Limits

MCP tool calls count against your API rate limit. Protocol messages (initialize, tools/list) are free.

Rate-limit headers are included in every response:

• X-RateLimit-Remaining — calls left this billing period
• X-RateLimit-Reset — when the limit resets (ISO 8601)
• Retry-After — seconds to wait (only on 429 responses)

Documentation

• Main site: https://quality-qr.app
• MCP setup guide: https://quality-qr.app/docs/mcp
• REST API reference: https://quality-qr.app/docs/api
• QR code types: https://quality-qr.app/docs/qr-types
• Pricing: https://quality-qr.app/pricing