# QRCodeChimp MCP > QRCodeChimp lets your AI agent handle every branded QR code task. Generate dynamic links, update digital business cards in bulk, and retrieve detailed scan analytics—all without opening the dashboard. It manages all your physical-to-digital touchpoints through natural conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** qr-codes, dynamic-links, digital-business-cards, campaign-tracking, branding, analytics ## Description You're running a bunch of QR codes—for digital business cards, marketing campaigns, whatever—and you don't wanna waste time clicking through some clunky dashboard. This server lets your AI agent handle every single branded code task directly in chat. Forget the manual navigation; it manages all your physical-to-digital touchpoints using natural conversation. Need to make a new code? Just pass the necessary data as a JSON string, and the system generates a brand new QR code for you right away via `create_qrcode`. If something changes—like the destination URL or the design of an active code—you can modify it instantly with `update_qrcode`. You'll also find that if you run a job creating multiple codes at once, you can check the status and details using `get_bulk_qr`. When it comes to finding your assets, you’ve got options. To see every single code you've ever made, just ask for a list using `list_qrcodes`. If you need an overview of all your active campaigns, run `list_campaigns`. You can also get a basic rundown on any specific QR code by calling `get_qrcode` to pull its core metadata and current status. Need help organizing everything? Use `list_folders` to see where your assets are stored, or check out `list_templates` for the available design options. To understand how well those codes are working, you can get deep data in two ways. For detailed insights—the geographical breakdown and when people tend to scan them most—you'll use `get_scan_stats`. If you just need a performance overview for one specific code, `get_analytics` pulls that data. You can also pull the general performance metrics for any single code through `get_scan_stats` or `get_analytics`. If you don't want a code anymore, you can remove it completely using `delete_qrcode`. It’s simple control over creation, modification, listing, and data retrieval. You just tell your agent what to do. ## Tools ### create_qrcode Generates a brand new QR code based on JSON data provided by your agent. ### delete_qrcode Removes an existing QR code asset from the system. ### get_analytics Retrieves detailed scan performance data for a specific QR code. ### get_bulk_qr Gets status and details for a job that created multiple QR codes at once. ### get_qrcode Retrieves the core metadata and current status of any single QR code. ### get_scan_stats Gets detailed scan analytics, including geographic breakdown and peak times, for a QR code. ### list_campaigns Lists all active QR campaigns you've set up in the system. ### list_folders Retrieves a list of all organizational folders where your QR code assets are stored. ### list_qrcodes Lists the basic metadata for every single QR code you have created. ### list_templates Shows available design templates you can use when creating or updating codes. ### update_qrcode Modifies an existing QR code's destination URL, design, or status. ## Prompt Examples **Prompt:** ``` Find the digital business card with slug 'john-doe-dbc'. ``` **Response:** ``` I've retrieved the card details for 'John Doe'. It is part of the 'Corporate Team' campaign and has received 150 scans this month. Would you like to see the full analytics report? ``` **Prompt:** ``` Generate a dynamic QR code for our product catalog landing page with our brand colors and logo. ``` **Response:** ``` Dynamic QR code created (ID: qr_8234). Target URL: catalog.example.com/products. Design: Custom with brand blue (#1A5FE1) foreground, white background, company logo embedded center. Format: SVG (vector, print-ready). Scan tracking: enabled. Short URL: qrco.de/prod2025. The dynamic URL can be changed anytime without reprinting. Current scan count: 0 (just created). Download available in SVG, PNG (300dpi, 1000x1000), and PDF formats. ``` **Prompt:** ``` Show me scan analytics for all QR codes from the Spring Marketing campaign. ``` **Response:** ``` Spring Marketing campaign: 8 QR codes, 4,567 total scans this month. Top performer: "Store Window Display" with 1,890 scans (41%). "Product Packaging" at 1,234 scans. "Flyer Insert" at 678 scans. Geographic breakdown: US 62%, UK 18%, Canada 12%, Other 8%. Peak scan time: weekdays 11 AM-2 PM. Mobile OS: iOS 58%, Android 42%. Unique scanners: 3,421 (75% unique rate). Conversion to website: 67%. ``` ## Capabilities ### Create New Codes Generate a brand new QR code by passing the data as a JSON string to create_qrcode. ### Update Existing Codes Change the destination or design of an already active QR code using update_qrcode. ### Get Performance Data Retrieve detailed scan analytics for a specific QR code via get_scan_stats or get_analytics. ### Manage Campaigns List and search through all your active QR campaigns using list_campaigns, giving you an overview of your assets. ### View Assets Retrieve metadata for a specific code or get details about bulk generation jobs using get_qrcode or get_bulk_qr. ## Use Cases ### Checking Event ROI A marketing manager needs to know if the 'Fall Promo' signage worked. They ask their agent: 'Show me scan stats for Fall Promo.' The agent executes `get_scan_stats`, returns a report showing 4,567 total scans and that 80% of them came from mobile users on iOS. Problem solved. ### Updating Team Cards Sales Ops needs to update 20 team members' DBCs because the company address changed. Instead of logging in 20 times, they ask the agent to run a bulk `update_qrcode` job on the list provided by `list_qrcodes`. The system updates all links instantly. ### Inventory Audit The asset coordinator needs a master list of every code ever created. They ask the agent to run `list_qrcodes` and get back a clean, searchable JSON dump of all current assets, making auditing simple. ### New Product Launch A product team needs 5 new QR codes for different landing pages. They prompt the agent to `create_qrcode` five times, providing the necessary JSON data each time. The system returns the IDs and immediate tracking links. ## Benefits - Get instant campaign reach data. Instead of checking a dashboard, just ask the agent to run `get_scan_stats` for any code and get geographic breakdowns (US 62%, UK 18%) right in chat. - Manage DBCs at scale. Use the AI to automate updating digital business cards across your team using `update_qrcode`, eliminating individual manual edits. - See campaign scope immediately. Run `list_campaigns` to get a quick, clear overview of all assets without having to navigate through nested folders or tabs. - Build assets fast. The agent can call `create_qrcode` with just the data you provide, generating fully tracked links and even providing download options (SVG, PNG) in one step. - Audit your content easily. Use `list_qrcodes` to pull a comprehensive list of every single code owned by the company for inventory checks. ## How It Works The bottom line is, your AI client handles the API communication, letting you talk about QR codes instead of writing code or navigating dashboards. 1. Subscribe to the QRCodeChimp MCP Server and input your API Key/Secret into your AI client's settings. 2. Reference a specific task (e.g., 'What were the scans for my sales team DBC?'). 3. Your AI agent calls the appropriate tool (`get_analytics`, `list_qrcodes`) and returns the structured data directly to the chat. ## Frequently Asked Questions **How do I check scan analytics using get_analytics?** You provide the specific QR code ID or slug to your agent. The agent then calls `get_analytics`, which returns detailed metrics like total scans and conversion rate directly in the chat. **Can I list all my campaigns using list_campaigns?** Yes, running `list_campaigns` gives you an immediate overview of every campaign asset group. This is useful for quickly seeing what assets are currently active and organized. **What if I need to change a code's destination? Do I use update_qrcode?** Yep, that’s the right tool. You give the agent the code ID and the new URL, and it uses `update_qrcode` to make the link live without you having to manually edit the dashboard. **How do I find out what codes exist on my account?** You can use `list_qrcodes` to pull a full list of every code. For more detail, run `get_qrcode` with the specific ID you want to check. **When I run `get_bulk_qr`, what details must I pass to ensure the job runs correctly?** You must provide a JSON string containing all necessary parameters for bulk generation. This ensures that every code created adheres to your defined brand rules and target URLs. **If `delete_qrcode` fails, how can I troubleshoot the error?** Check if the QR Code ID is correct and that you have deletion permissions for that asset. The response will specify the failure reason (e.g., unauthorized access or invalid ID). **How do I check the design options using `list_templates`?** Using `list_templates` returns a catalog of available designs and styles. You can then specify which template ID you want to use when creating or updating a code. **What is the difference between calling `get_qrcode` versus `get_scan_stats`?** `get_qrcode` retrieves the static metadata and details of the QR asset itself. Meanwhile, `get_scan_stats` provides performance data—the actual scan count and analytics for that code. **Can my AI automatically find the details for a specific digital business card by providing its slug?** Yes! Use the `get_qr_details` tool with the record slug (Page Code). Your agent will respond with complete metadata, including contact details and associated campaign info in seconds. **How do I find my QRCodeChimp API Key and Secret?** Log in to your QRCodeChimp account, navigate to **Account Settings** > **API Keys Settings**, and you will find your unique API Key and Secret there. **What plan do I need for API access?** API access typically requires a subscription to the **ULTIMA** plan or above. You may also need to contact support@qrcodechimp.com to activate the API functionality for your account.