io.github.silly-geese/quality-qr

Official6 tools

by silly-geese

Quality QR

Create and manage trackable QR codes with scan tracking, analytics, and dynamic URL updates.

Create and track QR codes with scan analytics and dynamic URL management.

Topics

ai-toolsclaudemcpmcp-serverqr-code

Captured live from the server via tools/list.

quality_qr_create

Create a new trackable QR code saved to your Quality QR account. Use this when the user wants to generate a QR code for a URL, WiFi network, contact card, calendar event, phone number, email, SMS, restaurant menu, app download link, or social media profile. The QR code is persisted with scan tracking and analytics. Returns an inline SVG image of the QR code.

Parameters (6)

typestringrequired
QR code content type. 'url' for websites, 'wifi' for network credentials, 'vcard' for contact cards, 'email' for pre-filled emails, 'phone' for tap-to-call, 'sms' for pre-filled texts, 'text' for plain text, 'event' for calendar events, 'pdf' for document links, 'menu' for restaurant menus, 'app-store' for app download links, 'social' for social media profiles.
contentstring
The content to encode. Required for url, text, pdf, menu, and app-store types. For url types, provide the full URL including https://. For other types, use the 'data' parameter instead.
namestring
A human-readable name for the QR code, e.g. 'Office WiFi' or 'Spring Menu 2026'. Auto-generated as 'MCP: {type} {date}' if omitted.
isDynamicboolean
Set to true to create a dynamic QR code whose destination URL can be changed later without reprinting the physical code. Only works for URL-based types (url, pdf, menu, app-store, social). Default: false.
dataobject
Type-specific structured data. Use instead of 'content' for complex types. WiFi: {ssid: string, password?: string, encryption?: 'WPA'|'WEP'|'nopass', hidden?: boolean}. vCard: {firstName: string, lastName: string, email?: string, phone?: string, mobile?: string, organization?: string, title?: string, website?: string, address?: {street?, city?, state?, zip?, country?}}. Event: {title: string, startDate: string (YYYY-MM-DD), startTime?: string (HH:mm), endDate?: string, endTime?: string, location?: string, description?: string, allDay?: boolean}. Social: {platforms: [{name: string, url: string, label: string}], profileName?: string, bio?: string}. Email: {to: string, subject?: string, body?: string}. Phone: {number: string}. SMS: {number: string, message?: string}.
designobject
Optional visual customization for the QR code.

quality_qr_list

List QR codes in the user's Quality QR account. Use this when the user wants to see their existing QR codes, find a specific code, or check how many codes they have. Returns ID, name, type, short URL, active status, and creation date for each code.

Parameters (3)

typestring
Filter results to only QR codes of this type. Omit to return all types.
limitnumber
Maximum number of results to return. Default: 50, maximum: 100.
offsetnumber
Number of results to skip for pagination. Default: 0.

quality_qr_get

Get full details of a specific QR code by its ID. Use this when the user wants to inspect a particular QR code's configuration, check its destination URL, view its design settings, or see its current status. Returns all metadata including content, destination, design, scan limits, and timestamps.

Parameters (1)

idstringrequired
The unique identifier of the QR code. Obtain this from quality_qr_list or quality_qr_create responses.

quality_qr_update

Update an existing QR code's properties. Use this when the user wants to change where a QR code points to, rename it, or enable/disable it. Destination URL changes only work for dynamic URL-based types (url, pdf, menu, app-store, social). Name and active status can be changed for any QR code type.

Parameters (4)

idstringrequired
The unique identifier of the QR code to update. Obtain this from quality_qr_list or quality_qr_create responses.
destinationUrlstring
New destination URL. Only works for dynamic URL-based types (url, pdf, menu, app-store, social). The physical QR code does not need reprinting.
namestring
New human-readable name for the QR code.
isActiveboolean
Set to false to disable the QR code (scans will stop redirecting). Set to true to re-enable it.

quality_qr_delete

Permanently delete a QR code from the user's account. Use this when the user wants to remove a QR code they no longer need. The short URL will immediately stop redirecting. This action frees up a plan quota slot and cannot be undone.

Parameters (1)

idstringrequired
The unique identifier of the QR code to permanently delete. Obtain this from quality_qr_list or quality_qr_create responses.

quality_qr_analytics

Get scan analytics for a specific QR code. Use this when the user wants to know how many times a QR code has been scanned, see daily scan trends, understand which devices are scanning, or see which countries scans come from. Returns total scans, scans by day, device breakdown (mobile/tablet/desktop), and top 5 countries.

Parameters (2)

idstringrequired
The unique identifier of the QR code to get analytics for. Obtain this from quality_qr_list or quality_qr_create responses.
daysnumber
Number of days of scan history to retrieve. Default: 30. Capped by plan: Free tier = 7 days max, Pro = 30 days, Business = 365 days.

README.md6 KBView on GitHub

Quality QR MCP Server

Create and manage trackable QR codes through AI assistants like Claude, Cursor, and any MCP-compatible tool.

Unlike generic QR code generators, Quality QR codes are saved to your account with scan tracking, analytics, and the ability to update destinations without reprinting.

Endpoint: https://quality-qr.app/api/mcp

Setup

1. Get an API Key

2. Configure Your MCP Client

Smithery users: If you install via Smithery, you'll be prompted for your apiKey directly — Smithery handles the Authorization header for you. The configs below are for manual setup.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

json

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

json

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

bash

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

3. Start Using It

Ask your AI assistant:

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

Available Tools

Tool	Description
`quality_qr_create`	Create a trackable QR code. 12 types: URL, PDF, Menu, App Store, Social, WiFi, vCard, Email, Phone, SMS, Text, Event. Returns an inline SVG.
`quality_qr_list`	List your QR codes with optional type filter and pagination.
`quality_qr_get`	Get full details of a QR code by ID.
`quality_qr_update`	Update destination URL (dynamic types), rename, or enable/disable.
`quality_qr_delete`	Permanently delete a QR code. Frees plan quota.
`quality_qr_analytics`	Scan analytics: totals, daily trends, device breakdown, top countries.

QR Code Types

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

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

Rate Limits

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

Plan	Tool Calls / Month	Analytics History	Price
Free	100	7 days	Free
Pro	1,000	30 days	€10/mo
Business	10,000	1 year	€30/mo

Rate-Limit Response Headers

Every response includes headers to help you manage usage:

Header	Description
`X-RateLimit-Limit`	Maximum tool calls allowed per month on your plan
`X-RateLimit-Remaining`	Tool calls remaining in the current billing period
`X-RateLimit-Reset`	UTC timestamp when the limit resets (ISO 8601)
`Retry-After`	Seconds to wait before retrying (only present on `429` responses)

When you receive a 429 Too Many Requests response, wait for the number of seconds specified in Retry-After before retrying.

Security

All requests authenticated via API key (Bearer token)
Keys can be revoked instantly from the dashboard
QR codes are scoped to your account (no cross-user access)
No admin, billing, or team management operations exposed
GDPR and CCPA compliant, hosted on Cloudflare's global edge network
See SECURITY.md to report a vulnerability, and PRIVACY.md for data handling details

API Key Management

Your API key grants full access to your QR codes and analytics. Treat it like a password.

Rotate regularly. Generate a new key in Dashboard > Settings > API Keys, update your MCP client config, then revoke the old key. You can have multiple active keys to allow zero-downtime rotation.
Revoke compromised keys immediately. Revocation takes effect instantly — any in-flight requests using the old key will fail.
Restrict access to config files. MCP client configs store your key in plaintext. On macOS/Linux, ensure only your user can read them (e.g., chmod 600). Avoid committing config files with real keys to version control.

Protocol

This is a remote MCP server using Streamable HTTP transport (JSON-RPC 2.0 over HTTP POST). No local installation required. Compatible with MCP protocol version 2025-03-26.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "quality-qr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://quality-qr.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.