qr-cow MCP server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@qr-cow MCP server Make a QR code for https://my-cafe.com/menu"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
qr-cow MCP server
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
Sign in at https://qr-cow.com.
Go to Dashboard → API & MCP.
Click Create token. Give it a name like "Claude Desktop".
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 and save a static or dynamic QR (URL, Wi-Fi, vCard, …) in your account. |
| 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 recent QR codes in your account. |
| Fetch one QR code with its current destination + design. |
| Change a dynamic QR's destination — the printed code keeps working. |
| Soft-delete a code. |
| Scans, unique scanners, country / device / hour-of-day breakdown. |
| 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-mcpThe 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_BASEyou configure) as aBearerheader.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
CONTRIBUTING.md — dev setup, style, how to send a PR.
CHANGELOG.md — what changed in each release.
RELEASING.md — how maintainers cut a release (tag → CI → PyPI).
License
Available Tools
8 toolscreate_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Create and edit dynamic QR codes from AI assistants via the QRay agent MCP endpoint.
Create and manage CodeQR short links, QR codes, and analytics from any MCP client.
Create and manage dynamic QR codes and read their scan analytics from Claude and other MCP clients.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.44MIT
- AlicenseNot gradedqualityDmaintenanceAn 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
- AlicenseBqualityDmaintenanceProduction-ready MCP server with 40+ tools — QR codes, PDFs, text processing, TTS, web scraping, image generation and more. Built for AI agents.2553 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP 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