MCP Server — AI Assistant Integration

QRelix's MCP server lets you manage your QR codes through AI assistants like Claude, ChatGPT, Cursor, and any tool that supports the Model Context Protocol. Create codes, update destinations, check analytics, and run bulk operations — all through natural language conversation.

MCP access is available on all paid QRelix plans. Don't have one yet? View pricing to get started.

What Is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and services. Instead of copying data between your dashboard and your AI tool, MCP gives the AI direct access to QRelix — so you can say "create a QR code for my spring campaign landing page" and it just happens.

Quick Setup

Claude Desktop

  1. Open Claude and go to Settings → Connectors
  2. Scroll to the bottom and click Add custom connector
  3. Enter QRelix.com as the name and paste the remote MCP server URL: 
    https://mcp.qrelix.com/mcp
  4. Claude will open a QRelix login window — sign in with your QRelix account
  5. Once connected, you can start managing QR codes in conversation

Claude Code (CLI)

Add QRelix to your Claude Code configuration:

{
  "mcpServers": {
    "qrelix": {
      "type": "url",
      "url": "https://mcp.qrelix.com/mcp"
    }
  }
}

Cursor

  1. Open Cursor Settings → MCP
  2. Click Add new MCP server
  3. Select Type: URL and enter: 
    https://mcp.qrelix.com/mcp
  4. Authenticate with your QRelix account when prompted

Other MCP Clients

Any application that supports MCP Streamable HTTP transport can connect to:

https://mcp.qrelix.com/mcp

The server supports OAuth 2.0 with dynamic client registration — your MCP client handles the auth flow automatically. No API keys needed.

Available Tools

Once connected, your AI assistant has access to these tools:

QR Code Management

Tool What It Does
create_qr Create a new QR code with a destination URL, label, and optional group
list_qrs List your QR codes with filtering by group, status, or search term
get_qr Get full details for a QR code — destination, scan count, download links
update_qr Change a QR code's destination URL, label, or status (active/paused)
delete_qr Permanently delete a QR code

Analytics

Tool What It Does
get_qr_stats Scan analytics for a specific QR code — visitors, locations, devices, daily counts
get_dashboard_summary Overview of your entire QR portfolio — totals, top performers, trends

Bulk Operations

Tool What It Does
bulk_create_qrs Create up to 100 QR codes in one operation
bulk_update_destination Update the destination URL for multiple codes at once (by ID list or group)

Example Conversations

Here are some things you can say to your AI assistant once connected:

Creating QR Codes

"Create a QR code that points to https://example.com/spring-sale and label it 'Spring Sale 2026'"

"Make 5 QR codes for each of our product pages — here are the URLs..."

Managing QR Codes

"Show me all my active QR codes in the Marketing group"

"Pause the QR code for the old landing page"

"Update all QR codes in the 'Holiday Campaign' group to point to our new URL"

Checking Analytics

"How many scans did my Spring Sale QR code get in the last 7 days?"

"Give me a summary of my QR code performance this month"

"Which QR code has the most scans?"

Authentication

QRelix uses OAuth 2.0 for secure authentication. When you first connect your AI assistant:

  1. Your MCP client discovers the auth configuration at https://mcp.qrelix.com/.well-known/oauth-authorization-server
  2. You're redirected to the QRelix login page to sign in
  3. After signing in, an access token is issued to your AI assistant
  4. The token refreshes automatically — you only need to log in once

Your AI assistant only has access to your QR codes and data. It uses the same permissions as your QRelix account.

Plan Requirements

MCP access is a paid feature. If you're on a free plan, any tool call will return a clear message:

MCP access requires a paid QRelix plan. Upgrade at https://qrelix.com/pricing

Your AI assistant will see this message and can relay it to you. OAuth sign-in works on all plans — the check happens when you try to use a tool, so you'll always know what to do next.

Rate Limits

To ensure reliable service for all users, MCP requests are rate-limited per account:

Plan Requests per Minute
Basic 60

If you exceed the limit, your AI assistant will receive a "rate limit exceeded" message with a retry timer. Normal conversational usage will rarely hit these limits.

Troubleshooting

"Authentication required" Error

Your access token may have expired. Disconnect and reconnect the MCP server in your AI assistant's settings to re-authenticate.

"Plan required" Error

MCP access requires a paid QRelix plan. Visit qrelix.com/pricing to upgrade.

Connection Timeout

Check that your AI assistant can reach https://mcp.qrelix.com. If you're behind a corporate firewall, you may need to allowlist this domain.

Tools Not Appearing

Make sure the MCP server URL is exactly https://mcp.qrelix.com/mcp (including the /mcp path). Restart your AI assistant after adding the server.

Technical Details

For developers and teams who want to understand the implementation:

Next Steps