The first QR code MCP server built for AI agents

Name: QR for Agent
Author: QR for Agent

Your AI agent can write code, send emails, and manage projects. Now it can create, update, and track dynamic QR codes too. One command. No dashboard. No bloat.

$ npx qr-for-agent

30 seconds from install to your first QR code.

Get Your API Key View on GitHub

See it in action

Ask your agent to create a QR code. It does.

Prompt

Create a branded QR code for our event page at
https://conf.example.com/2026 with rounded dots,
our logo, and indigo color scheme.

Agent response

{
  "short_id": "8x7k2m9p",
  "target_url": "https://conf.example.com/2026",
  "qr_image_url": "https://qrforagent.com/i/8x7k2m9p",
  "style": {
    "dot_style": "rounded",
    "foreground_color": "#4F46E5",
    "logo_url": "https://conf.example.com/logo.png"
  }
}

Your agent calls the MCP tools in natural language. No SDK to learn. No multiple API calls to chain. One prompt, one QR code -- dynamic, trackable, and updatable without changing the image.

Read the Docs

Three steps. That's it.

Install

Works with Claude Desktop, Cursor, and any MCP-compatible client. No config files. No Python paths. No environment variable debugging.

$ npx qr-for-agent

Configure

Add your API key:

{
  "mcpServers": {
    "qr-for-agent": {
      "command": "npx",
      "args": ["-y", "qr-for-agent"],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qragentcore.com"
      }
    }
  }
}

Create

Your agent now has 37 tools. Create styled QR codes, track scans and conversions, manage webhooks -- all in plain language.

Get Your API Key

Built for AI agents. Not retrofitted.

Most QR code services bolt on an API as an afterthought. QR for Agent is MCP-native from line one.

37 tools. Lean by design:

create_qr_code -- Generate a styled dynamic QR code with colors, shapes, and logo
get_qr_code -- Retrieve details and metadata for any QR code
update_qr_destination -- Change the destination URL without reprinting
list_qr_codes -- List all QR codes under an API key
delete_qr_code -- Remove a QR code permanently
bulk_create_qr_codes -- Create up to 50 QR codes in one request
bulk_update_qr_codes -- Update up to 50 QR codes in one request
bulk_delete_qr_codes -- Delete up to 50 QR codes in one request
create_vcard_qr -- Create a contact card QR code (vCard)
create_wifi_qr -- Create a WiFi network QR code
create_email_qr -- Create a pre-filled email QR code
create_sms_qr -- Create a pre-filled SMS QR code
create_phone_qr -- Create a phone call QR code
create_event_qr -- Create a calendar event QR code
create_text_qr -- Create a plain text QR code
create_location_qr -- Create a map location QR code
create_social_qr -- Create a social media links QR code
create_app_store_qr -- Create a smart app store redirect QR code
update_vcard_qr -- Update vCard QR code contact data
update_wifi_qr -- Update WiFi QR code credentials
update_social_qr -- Update social media links
update_app_store_qr -- Update app store URLs
get_qr_analytics -- Get scan count, timestamps, and referrer data
create_webhook -- Get notified in real time when a QR code is scanned
list_webhooks -- List all registered webhook endpoints
delete_webhook -- Remove a webhook endpoint
register -- Register for an API key with your email
get_usage -- Get current usage and quota for your API key
upgrade_to_pro -- Upgrade to Pro ($19/month) via Stripe Checkout
manage_billing -- Manage your subscription and payment method
set_utm_params -- Set UTM tracking parameters on a URL QR code
set_redirect_rules -- Set conditional redirect rules on a URL QR code
set_custom_domain -- Set or remove your branded short URL domain (Pro)
get_custom_domain -- Check custom domain configuration and DNS status
bulk_create_from_csv -- Create up to 500 QR codes from CSV data (Pro)
record_conversion -- Record a post-scan conversion event (purchase, signup)
get_conversions -- Get conversion stats, ROI data, and event breakdowns

37 tools. 3 dependencies. ~5 kB package. Your context window stays clean.

Dynamic QR Codes

Update where a QR code points after it's printed. No new image needed. Your agent handles it with a single prompt.

Custom Styled QR Codes

Colors, dot shapes, corner styles, logo embedding -- your agent creates on-brand QR codes in one prompt. No design tool needed.

Bulk Operations + CSV

Create, update, or delete up to 50 QR codes in one API call. Need more? Upload a CSV with up to 500 QR codes (Pro). Your agent handles campaign launches at scale.

11 QR Code Types

Not just URLs -- create URL, vCard, WiFi, Email, SMS, Phone, Event/Calendar, Text, Location, Social Media, and App Store QR codes. Your agent generates QR codes for any use case, with native mobile phone recognition.

Expiration & Scheduling

Set QR codes to expire or auto-switch destination at a future date. Your agent can create time-limited promotions or scheduled redirects without manual intervention.

Enriched Analytics

Device, browser, country breakdowns with daily trends and period filtering. Your agent pulls scan data segmented by device type, referrer, location, and time range -- not just raw counts.

UTM Tracking

Append UTM parameters (source, medium, campaign, term, content) to any URL QR code. Your agent sets tracking in one prompt -- no manual URL builder needed. Analytics tools pick up the tags automatically.

GTM Container

Inject your Google Tag Manager container into redirect pages. Track QR code scans with your existing GTM setup -- conversion pixels, GA4 events, remarketing tags -- all firing before the redirect.

Conditional Redirects

Route scanners to different URLs based on device, OS, country, language, time of day, or A/B split. Your agent configures rules in one prompt -- no redirect service needed.

Frames & Templates

Add decorative frames with CTA text around QR codes -- 'Scan Me!', 'View Menu', 'Get Tickets'. Three styles (banner top, banner bottom, rounded border) with custom colors. Your agent creates print-ready QR codes in one prompt.

Conversion Tracking

Measure QR code ROI. Track post-scan events (purchases, signups) via a zero-JS tracking pixel or authenticated API. Get breakdowns by event, day, and value. No analytics service needed -- it's built in.

Custom Domains

Brand your short URLs with your own domain. Instead of qrforagent.com/r/abc123, use qr.yourbrand.com/r/abc123. DNS verification included. Pro plan only.

Real-Time Webhooks

Get notified the instant a QR code is scanned or a conversion fires. HMAC-signed payloads, delivery logging, fire-and-forget -- your agent sets it up in one command.

Multi-Tenant Isolation

One API key per client. Build agents for multiple customers without data leaking between them. Agencies and consultants: this is for you.

REST API + MCP

Not using MCP? The full REST API works standalone. Every MCP tool maps 1:1 to an HTTP endpoint. Use whichever protocol fits your stack.

Lightweight by Design

The "too many tools" problem is real -- "context windows filling up with tool definitions, loading 50 tools meant burning 100K+ tokens before the conversation started." QR for Agent ships 37 tools at 5 kB. Your agent keeps its focus.

Read the Docs

QR for Agent vs. traditional QR code services

"Most QR code APIs are either overpriced, overcomplicated, or require using their hosted dashboard." Here's how we compare.

Feature	Traditional QR Services	QR for Agent
MCP integration	None (or via Zapier)	Native — 37 dedicated tools
Installation	Read 6 pages of docs, configure OAuth	`npx qr-for-agent`
API access	Pro plans only ($49+/month)	Free tier includes full API
QR codes after trial	Deactivated without warning	Your QR codes never expire silently
Context footprint	27+ tools, 60K tokens burned	37 tools, 5 kB total
Source code	Closed	Open source on GitHub
Dashboard required	Yes	No. API-first.
Pricing	"Contact Sales" or bait-and-switch	Free to start. Transparent. See pricing.

View pricing

What your agent builds with QR codes

AI agents are no longer just answering questions. They deploy apps, run workflows, and now -- they create real-world objects.

Marketing Campaigns

Your agent generates a unique dynamic QR code for each campaign, tracks scan analytics daily, and updates the destination URL when the landing page changes. No manual dashboard work. No broken links on printed flyers.

Event Management

"Create a QR code for the conference registration page." Done. Venue changes? Your agent updates the URL. After the event, it pulls scan data to measure attendance conversion.

Restaurant Menus

Generate a QR code per location. When the menu changes, your agent updates the link -- the printed QR on the table stays the same. Multi-tenant isolation keeps each restaurant's data separate.

Business Cards & Collateral

Your agent creates a dynamic QR code that points to a vCard or portfolio. When the contact changes jobs, update the destination. The printed card still works.

Read the Docs

Open source. No vendor lock-in.

The code is on GitHub. Read it. Fork it. Self-host it if you want.

QR for Agent is MIT-licensed. If we disappear tomorrow, your QR codes keep working. Teams keep rebuilding small but critical utilities -- QR codes, short URLs, tokens -- over and over again. We built it once, correctly, and opened the source.

Self-host on your infrastructure with Docker or Railway. Or use the hosted API and skip the ops work. Your call.

View on GitHub Read the Docs

Give your agent the power to create QR codes

MCP-native. API-first. Open source. Free to start.

$ npx qr-for-agent

Get Your API Key View on GitHub