×
MCP

QR Code MCP Server

Give your AI assistants a direct line to the QR Planet ecosystem. Built on the Model Context Protocol (MCP) and your AI workflows can spin up dynamic QR campaigns, reroute URLs, and track live scan analytics instantly using pure natural language.

What is the Model Context Protocol (MCP)?

MCP stands for Model Context Protocol. It’s a standard way for AI assistants and other AI applications to connect with external tools, systems, and data sources, such as our QR Code platform.

Why Use QR Code MCP?

Give your AI assistants real-world teeth. By exposing native capabilities to LLMs, you can automate logic directly inside your workspace.

  • Dynamic Content Routing: Let your agent create a single QR Code and dynamically update its destination URL based on time, campaign phases, or user analytics.
  • Context-Aware Analytics: Allow your AI agent to query scan statistics directly, generating summaries and marketing recommendations instantly without manual data exports.

Connecting via OpenCode

Add the following configuration block to your opencode.json configuration file.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "qrplanet-mcp": {
      "type": "remote",
      "url": "https://api.qrplanet.com/mcp",
      "enabled": true,
      "oauth": {
        "clientId": "opencode"
      },
      "scope": "mcp:tools"
    }
  }
}

How the integration works

Simplified MCP integration overview

In this MCP setup, your AI assistant acts as an MCP client that wants to use features from our QR Code Platform. Our QR Code Platform provides an MCP server that exposes supported platform actions and data in a structured way.

1. Configuration & Security

In your AI application (like Claude, ChatGPT, OpenCode, or Gemini), configure our platform as an MCP server. This tells the assistant how to connect. This architecture ensures the AI never connects directly to your internal database systems; all communication goes securely through the standardized MCP server layer.

2. Discovery & Capabilities

Once the connection is established, the AI assistant dynamically discovers which tools and resources are available. These tools represent supported platform actions, such as retrieving tracking statistics, dynamically creating or updating QR Code, accessing active campaign data, or running backend functions.

3. Request Routing

When a user asks the AI assistant to perform an action, the assistant evaluates the prompt and determines if a platform tool is required. If needed, it structuralizes a secure request and routes it to our MCP server, which validates the incoming payload and communicates safely with the core platform interfaces.

4. Response and Processing

The QR Code Platform processes the backend request and securely returns the raw data back to the MCP server. The MCP server translates this data into a structured format that the AI assistant natively understands, allowing the model to quickly formulate a clear, contextual final answer for the user.

How to connect to our MCP Server from various services

Connecting Claude Code to the QR Code MCP Server

Connect your Claude AI directly to your QR Code account. Use our MCP server to let Claude create, track, and manage dynamic QR Code campaigns seamlessly.

Connecting Claude Code to the QR Code MCP Server

Connecting OpenCode to the QR Code MCP Server

Learn how to connect OpenCode to the QR Planet Mobile Campaign Platform (MCP) server with our step-by-step guide. Streamline your QR Code workflows today.

Connecting OpenCode to the QR Code MCP Server

Available Tools and Capabilities

Once connected, your LLM will automatically gain access to a standardized schema of tools prefixed with your server's namespace. Try prompting your workspace agent with:

  • "Generate a dynamic QR Code for my new marketing page."

  • "Pull the scan metrics from last week's campaign and tell me which cities had the highest engagement."

QR Codes

POST
create_qr_code
Create a dynamic or static QR Code
GET
get_qr_code
Returns a single QR Code by its code
PUT
change_qr_code
Update target URL, title, description, folder, password, etc.
DEL
delete_qr_code
Delete a QR Code by its code
DEL
delete_all_qr_codes
Delete ALL QR Codes (irreversible — requires confirmation)
GET
list_qr_codes
List/paginate/filter QR Codes by type, title, tags, scan count, dates
GET
get_qr_code_stats
Get scan statistics for a QR Code (filterable by date/country)
POST
reset_qr_code_stats
Reset statistics for a QR Code

Tags

GET
get_qr_code_tags
Get tags assigned to a QR Code
PUT
change_qr_code_tags
Add/remove tags on a QR Code
DEL
delete_qr_code_tags
Remove all tags from a QR Code

Multi-Language / Geo Targeting

POST
add_qr_code_language
Add a language-specific target URL redirect
DEL
delete_qr_code_language
Remove a language-specific redirect
POST
add_qr_code_country
Add a country-specific target URL redirect
DEL
delete_qr_code_country
Remove a country-specific redirect
POST
add_qr_code_geofence
Add a geo-location (lat/lng/radius) target URL redirect
DEL
delete_qr_code_geofence
Remove a geofence redirect by rule ID
POST
add_qr_code_georegion
Add a region-specific target URL redirect
DEL
delete_qr_code_georegion
Remove a geo-region redirect by rule ID

Designer

POST
design_custom_qrcode
Design an existing QR Code with custom styling (patterns, colors, frames, logos)
POST
design_custom_qrcode_static
Design a static QR Code from scratch (no analytics)
POST
create_designer_template
Save a design as a reusable template
GET
get_designer_template
Get a single designer template by ID
GET
list_designer_templates
List all designer templates

GS1 Digital Link

POST
create_gs1
Create a GS1 Digital Link QR Code with GTIN, batch, serial, etc.
POST
create_gs1_rule
Add a LinkType/language rule to a GS1 Digital Link
GET
list_rules
List all rules of a GS1 Digital Link
DEL
gs1_delete_rules
Delete all rules of a GS1 Digital Link

Business Cards

POST
create_bcard
Create a digital business card (BCARD or VCARD)
GET
get_bcard
Get a single business card by code
PUT
change_bcard
Update fields on a business card
DEL
delete_bcard
Delete a business card
GET
list_bcards
List all digital business cards
POST
upload_bcard_image
Upload user/logo/background image for a business card

App Store QR Codes

PUT
change_app_store_qr_code
Update Apple/Google/Huawei/Amazon/Microsoft app store URLs

Coupons & Vouchers

GET
list_coupons
List all coupons
GET
get_coupon_stats
Get coupon issue statistics
GET
get_coupon_redemptions
Get coupon redemption statistics
POST
issue_voucher
Issue a voucher for a coupon (optional group & TTL)

Folders

POST
create_folder
Create a folder for QR Codes or landing pages
GET
get_folder
Get a single folder by ID
DEL
delete_folder
Delete a folder
GET
list_folders
List all folders (filterable by type)
GET
get_folder_stats
Get folder-level scan statistics
POST
reset_folder_stats
Reset statistics for all QR Codes in a folder

Leads

GET
get_leads
Export leads from a landing page (JSON/CSV/XLSX)

This website uses necessary cookies to ensure that our website is ideally usable. We do not use cookies that process personal data without your prior consent. Read our Cookie Policy