Skip to main content
Glama
qr-cow MCP server

qr-cow MCP server

Official
by qrcow

qr-cow MCP server

PyPI Python License: MIT CI

An MCP server that exposes the customer-facing qr-cow.com API to any MCP-compatible AI client (Claude Desktop, Claude Code, Cursor, Zed, …).

Once connected, you can say things like:

"Make a QR code that goes to https://my-cafe.com/menu, call it Café menu" "Render a styled QR for https://acme.com in the ocean preset, 600px" "Show me which countries scanned my café menu last week" "Change the destination of the café menu QR to /menu-v2"

…and the assistant calls the API on your behalf.


1. Create a token

  1. Sign in at https://qr-cow.com.

  2. Go to Dashboard → API & MCP.

  3. Click Create token. Give it a name like "Claude Desktop".

  4. Copy the qrc_live_… value that appears. It's shown once.

Related MCP server: Enhanced QR Code MCP Server

2. Wire it into your MCP client

Claude Desktop / Claude Code

Add to ~/.claude.json (or your platform's equivalent config):

{
  "mcpServers": {
    "qr-cow": {
      "command": "uvx",
      "args": ["qr-cow-mcp"],
      "env": {
        "QRCOW_API_TOKEN": "qrc_live_..."
      }
    }
  }
}

Restart the client. You should see qr-cow tools listed.

Cursor / Zed

Same shape — pass command, args, and an env block with QRCOW_API_TOKEN. See their MCP docs for the exact key.

Self-hosted qr-cow

Set QRCOW_API_BASE (defaults to https://qr-cow.com/api) to point at your install:

"env": {
  "QRCOW_API_TOKEN": "qrc_live_...",
  "QRCOW_API_BASE": "https://your-host/api"
}

Tools

Tool

What it does

create_qrcode

Create and save a static or dynamic QR (URL, Wi-Fi, vCard, …) in your account.

render_styled_qrcode

Render a fully styled QR image (dot/eye shapes, gradient, logo) from data plus a preset or style, without saving it. Returns the image.

list_qrcodes

List recent QR codes in your account.

get_qrcode

Fetch one QR code with its current destination + design.

update_qrcode_destination

Change a dynamic QR's destination — the printed code keeps working.

delete_qrcode

Soft-delete a code.

get_qrcode_analytics

Scans, unique scanners, country / device / hour-of-day breakdown.

me

The signed-in user's profile + current plan.


Develop locally

git clone https://github.com/qrcow/qr_cow_mcp.git
cd qr_cow_mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

# Try it out — auth doesn't matter for startup
QRCOW_API_TOKEN=qrc_live_local QRCOW_API_BASE=http://localhost:8080/api qr-cow-mcp

The server speaks stdio, so the easiest way to manually exercise it is through an MCP client.

Privacy & security

  • The server is a thin pass-through: your token stays in your MCP client config and is only ever sent to the qr-cow API (or the QRCOW_API_BASE you configure) as a Bearer header.

  • No telemetry, no third-party calls. Requests carry a User-Agent: qr-cow-mcp/<version> header so the API can distinguish MCP traffic.

Contributing & releases

License

MIT

Available Tools

8 tools
create_qrcodeA

Create and SAVE a QR code in the customer's qr-cow account (it appears on their dashboard and is tracked). Pick a content type and pass the content as a string. Static codes are unlimited on every plan; dynamic codes (editable + scan analytics) have a per-plan limit (the free plan includes a few). To just render a styled image without saving, use render_styled_qrcode instead.

Inputs: name (required), content (required), content_type (required), type, +2 more.

delete_qrcodeA

Soft-delete a QR code. Scans afterwards return 404.

Inputs: id (required).

get_qrcodeA

Fetch full details for one QR code by id, including current redirect URL for dynamic codes.

Inputs: id (required).

get_qrcode_analyticsA

Fetch scan analytics for one QR code: total scans, unique scanners, breakdown by country, device, and hour of day.

Inputs: id (required), days.

list_qrcodesB

List the customer's recent QR codes, newest first.

Inputs: limit.

meA

Return the authenticated user's profile + plan info.

Inputs: no named parameters.

render_styled_qrcodeA

Render a fully STYLED QR code image (colours, dot + eye shapes, gradient, logo, error-correction) from data and a style, WITHOUT saving it to the account. Great for generating codes in bulk. Use a preset for a ready-made look and/or set style fields to override. Returns the QR as an image (png/jpg) or SVG source. Stateless: this calls POST /v1/qr/render and stores nothing.

Inputs: data (required), size, style, format, +1 more.

update_qrcode_destinationA

Update a dynamic QR code's destination URL. The printed code doesn't change — only what scanning it leads to.

Inputs: id (required), content (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose. render_styled_qrcode is explicitly stateless and different from create_qrcode, while update_qrcode_destination, get_qrcode_analytics, and me serve unique roles without overlap.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (create_qrcode, list_qrcodes, get_qrcode, delete_qrcode, render_styled_qrcode, update_qrcode_destination, get_qrcode_analytics). The lone exception is 'me', which is a minor deviation in an otherwise predictable scheme.

    Tool Count5/5

    With 8 tools, the server is well-scoped for a QR code management service. Each tool fulfills a necessary operation without redundancy or excessive granularity, fitting comfortably in the ideal 3-15 range.

    Completeness5/5

    The tool set covers the full QR code lifecycle: create, read, list, delete, update (destination), plus rendering without saving, analytics, and user plan info. No significant gaps are evident for the stated purpose.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables generation of QR codes from text or URLs in multiple formats (DataURL, SVG, terminal display) with customizable options like error correction, colors, and size. Supports batch processing of multiple QR codes and integrates seamlessly with MCP-compatible clients.
      4
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An advanced MCP server for generating styled QR codes with logos, batch processing, and specialized formats like WiFi or vCards. It also provides tools to decode existing QR code images and analyze their quality or content.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server to generate QR codes from text or URLs, returning base64 PNG images, with pay-per-call via x402 micropayments (USDC on Base L2).
      MIT