QR for Agent

by benswel

Not rated
GitHub

About

Dynamic QR code MCP server for AI agents — create, update, track QR codes

Details

Author
benswel
Categories
Developer Tools, Other

Setup

Install QR for Agent in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/benswel/qr-agent-core

Follow the installation instructions in the repository README, then restart your MCP client.

QR-as-a-Service API built for AI agents. Create, update, and track dynamic QR codes programmatically via REST API or MCP (37 tools).

QR codes point to short URLs (/r/:shortId) that you can retarget at any time — the QR image never changes, but scanning it goes to the new destination. Multi-tenant by design, with full scan analytics.

Live API:api.qrforagent.com|Site:qrforagent.com|MCP:qr-for-agent

- Dynamic QR codes— change the destination URL without regenerating the image
- 11 QR types— URL, vCard, WiFi, Email, SMS, Phone, Event, Text, Location, Social, App Store
- Custom styling— dot shapes (square, rounded, dots, classy-rounded), corner styles, colors, gradients, logo embedding, frames with CTA text
- SVG & PNG— vector and bitmap output
- Enriched analytics— device type, browser, OS, country, city, referrer, scans-by-day
- Real-time webhooks— HMAC-SHA256 signed payloads with delivery logging
- UTM tracking— auto-append UTM parameters to redirect URLs
- GTM support— intermediate page with Google Tag Manager snippets
- Conditional redirects— route by device, OS, country, language, time range, or A/B split
- Custom domains— Pro users brand short URLs with their own domain (qr.yourbrand.com/r/abc123)
- Expiration & scheduling— auto-expire QR codes or schedule URL swaps
- Conversion tracking— tracking pixel + API for post-scan events (purchases, signups) with ROI analytics
- Frames & templates— decorative frames around QR codes (banner_top, banner_bottom, rounded) with CTA text
- Bulk operations— create, update, or delete up to 50 QR codes per request, or up to 500 via CSV upload (Pro)
- Multi-tenant— each API key sees only its own data
- MCP server
qr-for-agentwith 37 tools for Claude Desktop, Cursor, etc.
- Plan-based quotas— Free (10 QR, 1K scans/month) and Pro ($19/month, unlimited)
- Self-service registrationPOST /api/registerwith email, no credit card
- Stripe integration— checkout, billing portal, webhook-driven plan management
- OpenAPI docs— Swagger UI at/documentation
- AI-discoverable/.well-known/ai-plugin.jsonand/.well-known/mcp.json
- Open source— MIT license, self-hostable via Docker

git clone https://github.com/benswel/qr-for-agent-api.git cd qr-for-agent-api npm install npm run dev

On first startup, an API key is auto-generated and printed to the console.

curl -X POST http://localhost:3100/api/qr \ -H "Content-Type: application/json" \ -H "X-API-Key: qr_YOUR_KEY_HERE" \ -d '{"target_url": "https://example.com", "label": "My first QR"}'

QR Code Management (X-API-Keyrequired)

Custom Domain (X-API-Keyrequired, Pro only)

All/api/endpoints require anX-API-Keyheader.

- Format:qr_+ 32-character random string
- Auto-generated: on first startup if no keys exist
- Multi-tenant: each key only sees its own QR codes
- Create a key:npm run key:create "my-label"
- List keys:npm run key:list

Public endpoints (/r/,/i/,/health,/documentation,/.well-known/) don't require auth.

Published asqr-for-agenton npm. 37 tools for AI agents to manage QR codes natively.

Add to your MCP config (claude_desktop_config.jsonor.cursor/mcp.json):

{ "mcpServers": { "qr-for-agent": { "command": "npx", "args": ["-y", "qr-for-agent"], "env": { "API_KEY": "your-api-key", "BASE_URL": "https://api.qrforagent.com" } } } }
npm run db:generate # Generate migration from schema changes npm run db:migrate # Apply pending migrations npm run db:studio # Open Drizzle Studio (web UI)

Migrations run automatically on server startup.

The database is persisted in a Docker volume.

The project includesrailway.tomland a multi-stageDockerfile. Connect your GitHub repo to Railway — it builds and deploys automatically with health checks on/health.

195 integration tests covering all endpoints, auth, multi-tenant isolation, QR types, webhooks, bulk operations, custom domains, frames, conversions, CSV upload, and analytics.

npm test # Run all tests npm run test:watch # Watch mode

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Converts LaTeX mathematical expressions to MathML format using MathJax-node.

Revdoku lets Claude, Codex, ChatGPT, and other AI agents publish generated reports, dashboards, prototypes, and app sites as real websites with stable URLs.

Manage and utilize website content within the DevHub CMS platform

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses

An MCP server tailored for React Native–first development using Gluestack UI

Create and read feature flags, review experiments, generate flag types, search docs, and interact with GrowthBook's feature flagging and experimentation platform.

Make your AI agent speak every language on the planet, using Lingo.dev Localization Engine.

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control.

Understand, develop, and debug authorization policies in Oso Cloud.

Up-to-date documentation for your coding agent. Covers 1000s of public repos and sites. Built by ref.tools

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.