QR for Agent
About
Dynamic QR code MCP server for AI agents — create, update, track QR codes
Details
- Author
- benswel
- Categories
- Developer Tools, Other
Jump to
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 registration—POST /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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





