What You Can Do With It

The Scan QR Labs MCP server gives AI clients direct access to QR creation, content management, styling, folders, collections, and analytics. Instead of clicking through multiple screens, you can describe what you want and let your assistant build it with the right tool calls.

1

Create QR Codes by Prompt

Ask for a website, WiFi, vCard, coupon, event, PDF, social page, or other supported QR type.

2

Organize and Brand at Scale

Use folders, collections, saved styles, and themes to keep larger accounts tidy and consistent.

3

Update Dynamic Destinations Later

Keep the same printed QR and update where it sends people after it is already live.

4

Measure What Happens After Launch

Pull scan trends, top countries, and device data directly into your AI workflow.

MCP Workflow

AI client to live QR

Dynamic

Prompt

Create a website QR named "Spring Campaign Poster" and point it at our landing page.

1

Account

2

Type schema

3

Create QR

{

"id": "qr_123...",

"type": "website",

"scan_url": "https://scanqrlabs.com/q/abc123"

}

Quick Setup

Add the server to your AI client, point it at the Laravel app, and use your Scan QR Labs account email.

1

Claude Desktop

Add the Scan QR Labs server to your Claude Desktop MCP config, then restart Claude.

{
  "mcpServers": {
    "scanqr": {
      "command": "/Applications/MAMP/bin/php/php8.3.30/bin/php",
      "args": ["/path/to/scanqrlabs.com/artisan", "mcp:start", "scanqr"]
    }
  }
}

2

Cursor

Use the same PHP 8.3 binary and point the server args at your local artisan file.

{
  "mcpServers": {
    "scanqr": {
      "command": "/Applications/MAMP/bin/php/php8.3.30/bin/php",
      "args": ["/path/to/scanqrlabs.com/artisan", "mcp:start", "scanqr"]
    }
  }
}

Set Your Account Email

Add your email to the Scan QR Labs environment so the MCP server knows which account to resolve:

[email protected]

After saving your config and environment, restart the AI client so it reloads the server definition.

Step-by-Step: Create Your First QR

This is the fastest path for a dynamic website QR code, which is the best starting point for most campaigns.

1

Confirm the Account and Available Features

Start with the account tool so your AI assistant can see plan limits, feature access, and the account context it is working inside.

Suggested prompt

Use get-account-tool and summarize what this Scan QR Labs account can create right now.

2

Inspect the Supported QR Schema

Before creating a QR, have the assistant check the canonical schema. For a simple redirect, choose the website type and provide a URL.

Suggested prompt

Use list-content-types-tool and show me the required fields for a website QR and a wifi QR.

3

Create the QR Code

For a dynamic website QR, the shortest payload uses type, name, content_url, and is_dynamic. Dynamic QR codes route through the platform so you can update the destination later and track scans.

{
  "type": "website",
  "name": "Spring Campaign Poster",
  "content_url": "https://scanqrlabs.com/spring",
  "is_dynamic": true
}

Use is_dynamic: false for fully self-contained QR types such as offline WiFi, text, or vCard payloads.

4

Style, Organize, and Track

Once the QR exists, the rest of the MCP toolkit becomes useful. Save it into a folder, apply a style, update its content later, and pull analytics when scans start coming in.

Follow-up tools

list-styles-tool, create-style-tool, list-folders-tool, create-folder-tool

After launch

update-qr-content-tool, get-analytics-tool, get-qr-code-tool

Every MCP Tool Available Today

The server is not limited to QR creation. It also exposes reusable content, organization, branding, and analytics workflows.

2

Account & analytics

get-account-tool

Check plan details, quotas, and available features.

get-analytics-tool

Review scans for one QR or your whole account.

6

QR codes

list-qr-codes-tool

Browse QR codes by search, type, or status.

create-qr-code-tool

Create dynamic or static QR codes with full content payloads.

get-qr-code-tool

Load one QR code with content, style, folder, and scans.

update-qr-code-tool

Rename, pause, archive, or move a QR code.

delete-qr-code-tool

Soft-delete a QR code so it stops resolving scans.

update-qr-content-tool

Swap the destination behind a dynamic QR without reprinting it.

7

Content & destinations

list-content-types-tool

See every supported QR content type and its required schema.

list-content-tool

Browse reusable destination content records by type.

create-content-tool

Create standalone business pages, events, coupons, PDFs, and more.

get-content-tool

Inspect one content record by ID and type.

update-content-tool

Edit reusable content without rebuilding the QR code.

delete-content-tool

Soft-delete standalone content.

attach-content-tool

Connect an existing content record to a QR code of the same type.

4

Organization

list-folders-tool

See your folders and QR counts.

create-folder-tool

Create folders for campaigns, teams, or locations.

list-collections-tool

View grouped QR collections such as trails or workflows.

create-collection-tool

Create a new QR collection for grouped experiences.

4

Styles & branding

list-styles-tool

Browse saved QR styles and their usage counts.

create-style-tool

Create branded styles with colors, frames, and logos.

list-content-brands-tool

List landing-page brand themes for supported content types.

create-content-brand-tool

Create a reusable brand theme for public destination pages.

Prompt Ideas You Can Paste Into Your AI Client

These are practical requests that work well once the Scan QR Labs MCP server is connected.

Use get-account-tool, then tell me what QR features are enabled on this account.

Use list-content-types-tool and show me the schema for a website QR and a WiFi QR.

Create a dynamic website QR named "Spring Campaign Poster" that sends people to https://scanqrlabs.com/spring.

Create a folder for trade show leads, then move my newest website QR into it.

Show me the last 30 days of scans for my latest QR and summarize the top countries and devices.

Build With AI

Ready to Connect the MCP Server?

Start with the MCP guide if you want your AI client to create and manage QR codes for you, or use the visual builder if you prefer a no-code workflow.

Open Developer Docs Try QR Builder

Frequently Asked Questions

Common questions about the Scan QR Labs MCP server

What is the easiest QR type to start with?

A dynamic website QR is the best first step. It only needs a destination URL, it is easy to test, and you can update the redirect later without printing a new code.

Can the MCP server create more than website QR codes?

Yes. The server supports static types such as text, WiFi, email, phone, SMS, and vCard, plus richer dynamic content such as business pages, coupons, events, PDFs, videos, image galleries, social pages, menus, tasks, and more.

How do I see the exact payload for a QR type?

Use list-content-types-tool. It returns the canonical field schema for each supported QR type and shows whether the payload belongs in content or microapp.

Can I update a QR after it is printed?

Yes, if the QR is dynamic. Use update-qr-content-tool to change the destination while keeping the printed code the same. Fully self-contained static QRs cannot be changed after creation.

Does the MCP server include analytics?

Yes. get-analytics-tool can return account-wide scan summaries or analytics for one specific QR code, including totals, daily trends, countries, and devices.

Still have questions?

View all FAQs

How to Use the MCP Server to Create QR Codes