MCP Server

Active

MIT

QRcodly MCP Server

de.qrcodly/mcp-server

Create, customize, and track QR codes with URL shortening and analytics

What is the QRcodly MCP server?

QRcodly is a free, open-source QR code generator and management platform. It enables creation of multiple QR code types (URL, vCard, Wi-Fi, Email, Calendar, Location, Text) with full customization options, export formats, URL shortening, scan analytics, and custom domain support via Cloudflare integration.

QRcodly lets you generate and manage QR codes for various data types with extensive customization, export to PNG/JPEG/SVG, shorten URLs with analytics tracking, save reusable templates, and use custom domains for short links. It's useful for marketing campaigns, contact sharing, event promotion, and any scenario requiring trackable QR codes.

How to install QRcodly

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

Environment / auth

Authorization
required
secret
Bearer token for API authentication (format: Bearer <your-api-key>)

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.qrcodly.de/mcp"
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

QR Code Generation — Create QR codes for URLs, vCard, Wi-Fi, Email, Calendar events, Location, and plain text
QR Code Customization — Customize colors, sizes, backgrounds, and upload custom icons
Export Formats — Export QR codes as PNG, JPEG, or SVG
URL Shortening — Shorten URLs and track scan analytics
Templates — Save and reuse QR code configurations
Custom Domains — Use your own domain for short URLs with Cloudflare integration

Use cases

Generate branded QR codes for marketing campaigns with custom colors and logos
Create Wi-Fi QR codes for events or businesses to simplify guest network access
Track QR code scan analytics to measure campaign performance and user engagement
Build contact-sharing QR codes (vCard format) for business cards and networking
Set up short URLs with custom domains for professional link sharing and tracking

QRcodly MCP server FAQ

What is QRcodly?

QRcodly is a free, open-source platform for creating, customizing, and managing QR codes with support for multiple data types (URLs, contacts, Wi-Fi, events), analytics tracking, and URL shortening.

Is QRcodly free to use?

Yes, QRcodly is free and open-source under the MIT License.

What QR code types does it support?

It supports URL, vCard (contact), Wi-Fi credentials, Email, Calendar events, Location, and plain text QR codes.

Can I customize the appearance of QR codes?

Yes, you can customize colors, sizes, backgrounds, and upload custom icons for branding.

Does it track QR code scans?

Yes, QRcodly includes URL shortening and analytics to track scans and measure engagement.

Can I use my own domain for short URLs?

Yes, QRcodly supports custom domains for short URLs via Cloudflare integration.

README (reference)

Source of truth, from the repository.

QRcodly

QRcodly is a free, open-source QR code generator and management platform. Create, customize, and track QR codes for URLs, contact details, Wi-Fi credentials, and more.

Features

Multiple QR code types — URL, vCard, Wi-Fi, Email, Calendar Event, Location, Plain Text
Full customization — colors, sizes, backgrounds, and custom icon uploads
Export formats — PNG, JPEG, SVG
URL shortening & analytics — shorten links and track scans
Templates — save and reuse QR code configurations
Custom domains — use your own domain for short URLs (Cloudflare integration)
Internationalization — 8 languages (EN, DE, ES, FR, IT, NL, PL, RU)
Authentication — powered by Clerk
Browser extension — generate QR codes from any page

Monorepo Structure

qrcodly/
├── apps/
│   ├── backend/            # Fastify REST API
│   ├── frontend/           # Next.js web application
│   └── browser-extension/  # Vite-based browser extension
├── packages/
│   ├── shared/             # Zod schemas, DTOs, and shared utilities
│   ├── eslint-config/      # Shared ESLint configuration
│   └── typescript-config/  # Shared TypeScript configuration
└── docker-compose.yaml     # Local development services

See per-app READMEs for architecture details: Backend · Frontend · Browser Extension · Shared Package

Tech Stack

Layer	Technologies
Frontend	Next.js, React, TypeScript, Tailwind CSS, shadcn/ui, Zustand, TanStack Query, next-intl
Backend	Fastify, TypeScript, Drizzle ORM, tsyringe (DI), Zod, Nodemailer, Handlebars
Database	MySQL, Redis
Storage	S3 / MinIO
Auth	Clerk
Billing	Stripe
Analytics	Umami, PostHog
Monitoring	Axiom, Sentry

Prerequisites

Node.js >= 22.11
pnpm >= 9.15
Docker (for local development services)

Quick Start

# 1. Clone the repository
git clone https://github.com/FloB95/qrcodly.git
cd qrcodly

# 2. Install dependencies
pnpm install

# 3. Start local services (MySQL, Redis, MinIO, Umami)
docker-compose up -d

# 4. Set up environment variables
cp apps/backend/.env.example apps/backend/.env
cp apps/frontend/.env.example apps/frontend/.env
# Edit both .env files with your configuration (Clerk keys, etc.)

# 5. Start development servers
pnpm run start:dev
# Backend API → http://localhost:5001
# Frontend   → http://localhost:3000

Available Scripts

Script	Description
`pnpm run start:dev`	Start backend and frontend in development mode
`pnpm run backend:dev`	Start backend only (runs migrations first)
`pnpm run frontend:dev`	Start frontend only
`pnpm run build`	Build all apps
`pnpm run build:shared-package`	Build the shared package only
`pnpm run lint`	Lint all workspaces
`pnpm run format`	Format all files with Prettier
`pnpm run clean`	Clean build artifacts across all apps

Local Services (Docker Compose)

Service	Port	Details
MySQL	3306	Credentials: `root` / `root`, database: `qrcodly`
Redis	6379	—
MinIO (S3)	9000 (API), 9001 (Console)	Credentials: `minio` / `testtest`
phpMyAdmin	8081	—
Umami Analytics	3001	—

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines and setup instructions.

License

This project is licensed under the MIT License.

Related MCP servers

TypeScript

AGPL-3.0

View repository →

de.tabak-brucker.www/shop

Tabak Brucker in ChatGPT/Claude: Katalog, Beratung, Angebote & Warenkorb-Hand-off. Kauf 18+ im Shop.

UGC VZ Creator Search

Find real UGC creators in the DACH region: profiles, pricing, reach, outreach. No API key.