# Flowcode MCP MCP > Flowcode manages dynamic QR codes and landing page data through your agent. It lets you create new codes for print campaigns, track real-time scan performance, monitor conversions from physical interactions, and pull detailed audience demographics—all without leaving your chat client. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** qr-codes, conversion-tracking, mobile-marketing, audience-analytics, dynamic-links, offline-to-online ## Description Connecting Flowcode via the Model Context Protocol (MCP) gives your AI client a full marketing dashboard in natural conversation. You stop jumping between QR code platforms, analytics sites, and CRM dashboards. Instead, you tell your agent what you need: 'Show me the top 5 locations for last month's scans,' or 'What were the lead contacts from Campaign X?' The MCP lets your AI client perform those actions instantly. It handles everything from listing all existing codes to generating a new one with specific redirect rules. This kind of centralized control is available through the Vinkius catalog, letting you manage entire campaign funnels and get deep audience insights without ever opening another tab. ## Tools ### create_flowcode Creates a brand new dynamic QR code linked to a specific URL. ### get_flowpage_contacts Pulls the CRM contact information submitted through the landing page forms. ### get_audience_summary Retrieves a summary of the demographics, like age and gender, for your audience. ### get_flowcode_image Generates and retrieves the image file for a given dynamic QR code. ### get_flowcode Gets specific details about an existing dynamic QR code. ### get_flowpage_analytics Retrieves event data detailing user activity on your landing pages. ### get_geographic_analytics Shows where scans are happening, listing specific geographic locations and regions. ### get_recent_scans Lists the activity log, showing a history of recent scan events. ### list_campaigns Retrieves a list and summary of all active marketing campaigns you've run. ### list_conversion_rates Calculates the conversion rate, showing how many scans turn into visits or leads. ### list_flowcodes Lists all your existing dynamic QR codes and their current status. ### list_folders Shows a directory of asset folders used to organize marketing materials. ## Prompt Examples **Prompt:** ``` List my 10 most recent Flowcodes and their scan counts. ``` **Response:** ``` Fetching Flowcodes... I found your 10 most recent dynamic QR codes, including 'Fall Campaign' (1,250 scans) and 'Product Demo' (450 scans). Would you like to see the geo-analytics for any of these? ``` **Prompt:** ``` Create a new Flowcode named 'Store Launch' redirecting to 'https://vinkius.com'. ``` **Response:** ``` Flowcode created! I've generated a new dynamic QR code named 'Store Launch' pointing to vinkius.com. The code ID is 'code_123'. I can provide the image download link whenever you're ready. ``` **Prompt:** ``` Show me the audience demographic summary for my account. ``` **Response:** ``` Retrieving audience data... Your engagement is primarily coming from users aged 25-34 (45%) using mobile devices. The top scan locations are New York and London. Would you like a more detailed breakdown? ``` ## Capabilities ### Create New Codes Generate a new dynamic QR code instantly for any destination URL. ### Analyze Audience Demographics Pull aggregate data about the age, gender, and location of people who scan your codes. ### Track Scan Activity Review detailed logs to see exactly when and where a code was scanned. ### Extract Lead Contacts Retrieve the CRM contact information submitted by users on your landing pages. ### Check Funnel Performance Calculate and review conversion rates across different stages, from scan to visit. ## Use Cases ### Auditing a Poorly Performing Campaign A brand director spots low conversions. Instead of just checking total scans, they ask the agent to cross-reference `get_audience_summary` with `get_geographic_analytics`. This reveals that 90% of poor performance comes from one specific region or age group, allowing for targeted retargeting. ### Preparing for a Sales Meeting A sales lead needs proof of recent activity. They prompt the agent to run `list_recent_scans` and then immediately pull `get_flowpage_contacts`. This gives them fresh, actionable names and emails from people who interacted with the site in the last 48 hours. ### Launching a New Print Campaign A marketing manager needs a code fast. They ask the agent to `create_flowcode` for their new product page, then immediately use `get_flowcode_image` to download the printable asset and confirm its redirect path. ### Reviewing Website Performance A digital specialist wants a holistic view of their site. They ask the agent for `list_campaigns`, then drill down using `get_flowpage_analytics` to see exactly what events users triggered on the landing page, identifying friction points. ## Benefits - Stop guessing about your campaigns. Instead of just seeing a total count, you can use `list_conversion_rates` to understand if scans are actually turning into leads or just viewing the page. - Never manually check location data again. You can pull specific geographic analytics using `get_geographic_analytics` and know exactly where your campaign is succeeding globally. - Capture lead data without friction. The agent retrieves submitted contact info via `get_flowpage_contacts`, giving sales a clean list of qualified leads immediately after an offline interaction. - Build new assets faster. Need a code for a pop-up flyer? Just use `create_flowcode` and get the full setup instantly, without logging into a separate portal. - Keep track of everything in one place. You can run `list_campaigns` to see all efforts, then dive deep with `get_audience_summary` for demographic breakdowns on the best performers. ## How It Works The bottom line is: you talk to your agent like a person, and it talks to Flowcode's backend like an engineer. 1. Subscribe to the Flowcode MCP through Vinkius and provide your API key. 2. Your AI client authenticates with the connector, giving it access to all marketing data. 3. You prompt the agent using natural language commands (e.g., 'List all my campaigns'), and the necessary tools execute automatically. ## Frequently Asked Questions **How do I check if my QR codes are still working? (Using list_flowcodes)** Run `list_flowcodes` to see all your existing dynamic QR codes. The agent provides their status and basic metadata so you know which ones are active or paused. **What is the best way to find lead contacts? (Using get_flowpage_contacts)** To pull submitted leads, use `get_flowpage_contacts`. This function specifically targets and retrieves CRM-ready contact information submitted by users on your landing pages. **Can I generate a new QR code with this MCP? (Using create_flowcode)** Yes, you can. Simply ask the agent to `create_flowcode`, providing the desired URL and name. It handles the entire generation process for you. **How do I see where my audience is located? (Using get_geographic_analytics)** Ask for `get_geographic_analytics`. This tool pulls detailed location data, allowing you to pinpoint whether your campaign success is concentrated in a specific city or region. **How do I use `list_campaigns` to get an overview of my active marketing efforts?** It lists every campaign you have set up in Flowcode. You can quickly see the names, associated codes, and overall status for all your ongoing or completed projects. **What specific data does `get_audience_summary` provide about my users?** This tool gives you aggregate demographic data on who is scanning your codes. You get breakdowns by age group, device type, and gender distribution to understand your core user base. **I'm worried about my funnel performance; how do I check it using `list_conversion_rates`?** It reports the conversion rates across different stages of your marketing funnel. This helps you spot where users are dropping off, allowing you to optimize specific parts of your landing page experience. **How can I use `list_folders` to manage my assets and projects?** The tool shows the complete hierarchy of asset folders within your account. This is crucial for maintaining a clean, structured organization across all your different marketing codes and materials. **Can I change the destination URL of a Flowcode after it has been created?** Yes! Flowcodes are dynamic by default. You can use the 'create_flowcode' or future update tools via the agent to manage your redirect rules without needing to change the physical QR code image. **How do I see where my QR codes are being scanned geographically?** You can use the 'get_geographic_analytics' tool. The agent will retrieve a summary of scan distribution across different regions, helping you understand where your offline audience is most active. **Can I retrieve contact info from users who scanned my codes?** Yes! If you have forms on your Flowpages, you can use the 'get_flowpage_contacts' tool to retrieve submissions, including names and emails, directly through the agent.