Business Feature

Ask Claude or ChatGPT about your QR codes

Connect your AI assistant to QRFlow once. Then ask how your codes are doing, in plain words. Compare codes, find your busiest days and hours, and analyze form responses.

How did the patio menu code do last week?

Used QRFlow · get_code_analytics

Patio Table Tent had 214 scans from 163 unique scanners last week, up 18% on the week before.

Friday was the busiest day, with 61 scans. 9 in 10 scans came from phones, and most came from Toronto.

What did people pick on the feedback form?

Sample conversation

Compare your codes

Ask which code did best this month. The assistant ranks your codes by scans for any range up to a year, across the account or in one folder.

Find your busiest days and hours

Scans and unique scanners for each day, counted in your timezone, so a Friday evening scan counts on Friday. Scans by hour of day show when people scan.

See where people scan

The top countries and cities, the share of scans from phones, and the languages of the browsers that scanned.

Sum up form answers

Count the options people picked, and read the newest answers. You choose if each connection can read form answers.

Follow Multi-Link taps

See which buttons on a link page get the taps, and the share of visitors who tapped one.

Use it in your own tools

An API key gives Claude Code, Cursor, scripts and dashboards the same numbers as your analytics page.

Connect in 3 Steps

  1. 1

    Add a custom connector

    In Claude, ChatGPT, Gemini or Grok, add a custom connector. The exact menus for each assistant are below.

  2. 2

    Paste this address

    Paste https://qrflow.co/mcp as the server address. The same address works in Claude and in ChatGPT.

  3. 3

    Sign in and allow

    Sign in to QRFlow and press Allow. Then ask about your codes. It can only read: it cannot change anything in QRFlow.

Questions to Ask

Which of my codes did best in October?

A ranking of your codes by scans in that month, with the all-time count beside each one.

What was the busiest day for the patio menu?

Scans and unique scanners for each day, read in the code's own timezone.

Where do people scan the trade show flyer?

The top countries and cities, and how many scans came from phones.

What did people pick on the feedback form this week?

A count for each option, and the newest answers when you want to read them.

Set It Up in Your Assistant

The exact menus for Claude, ChatGPT, Gemini, Grok and tools that take an API key.

Claude

  1. 1

    Add a custom connector

    In Claude, open Customize, then Connectors. Click + Add, then Add custom connector. Add it on claude.ai or in the desktop app. It then works in the Claude mobile app too.

  2. 2

    Paste the address

    Type QRFlow as the Name. Paste this address as the MCP server URL, then click Add.

    https://qrflow.co/mcp
  3. 3

    Connect and allow

    Click Connect and sign in to QRFlow. Check what Claude can read, then click Allow. It can only read. It cannot create, change or delete anything.

On Team and Enterprise, an owner adds QRFlow once: in Organization settings, open Connectors, click Add, hover over “Custom”, then select “Web”. Each member then opens Customize, then Connectors, finds QRFlow (marked “Custom”) and clicks Connect.

ChatGPT

  1. 1

    Add a custom MCP server

    On ChatGPT on the web, open chatgpt.com/plugins. Open the Add menu at the top right, then click Add custom MCP server.

  2. 2

    Paste the address

    Type QRFlow as the Name. Set Connection to Server URL and paste this address. Set Authentication to OAuth, and keep the Advanced OAuth settings as they are.

    https://qrflow.co/mcp

    The Icon is optional. To show the QRFlow icon, download it here (PNG, 324 x 324 px, 7 KB).

  3. 3

    Sign in and allow

    Tick I understand and want to continue, then sign in to QRFlow. Check what ChatGPT can read, then click Allow. ChatGPT shows a general warning about apps that change or delete data. QRFlow can only read: it cannot create, change or delete anything.

On a Business, Enterprise or Edu workspace, an admin may need to allow custom MCP servers first.

Gemini

  1. 1

    Add a custom connector

    In Gemini, open Customize, then Connectors, and click + Custom.

  2. 2

    Paste the address

    Type QRFlow as the name and paste this address.

    https://qrflow.co/mcp
  3. 3

    Sign in and allow

    Sign in to QRFlow. Check what Gemini can read, then click Allow. It can only read. It cannot create, change or delete anything.

Grok

  1. 1

    Add a custom connector

    In Grok, open your Profile, then Settings, then Connect Apps. Scroll down and click Add a custom connector.

  2. 2

    Paste the address

    Type QRFlow as the name and paste this address.

    https://qrflow.co/mcp
  3. 3

    Sign in and allow

    Sign in to QRFlow. Check what Grok can read, then click Allow. It can only read. It cannot create, change or delete anything.

Other tools (API key)

  1. 1

    Create an API key

    In QRFlow, open Settings, then AI assistants and API, and click Create API key. Choose if it can read form answers. Copy the key: QRFlow shows it one time only.

  2. 2

    Add it to your tool

    For Claude Code, run this command with your key:

    claude mcp add --transport http qrflow https://qrflow.co/mcp \
      --header "Authorization: Bearer YOUR_API_KEY"

    In Cursor and other MCP clients, add a remote server with the address https://qrflow.co/mcp and the header Authorization: Bearer YOUR_API_KEY.

  3. 3

    Or call the REST API

    Scripts, spreadsheets and dashboards can read the same data at https://qrflow.co/api/v1. The paths are in “For developers” below.

A key works on the MCP address and on the REST API. Revoke it in Settings at any time.

For developersThe REST API: the header, the endpoints, the errors and the limits.

The header

Every call is a GET to https://qrflow.co/api/v1/... with this header. The MCP server at https://qrflow.co/mcp takes the same key.

Authorization: Bearer <key>

Endpoints

Each one gives the JSON of the MCP tool with the same name. The query parameters have the names of the tool’s arguments.

  • GET /api/v1/codes

    list_qr_codes · parameters: search, folder_id, content_type, status, limit, cursor

  • GET /api/v1/folders

    list_folders · parameters: none

  • GET /api/v1/codes/{code}/analytics

    get_code_analytics · parameters: start, end, days, time_zone

  • GET /api/v1/rankings

    rank_codes · parameters: start, end, days, time_zone, folder_id, content_type, limit

  • GET /api/v1/codes/{code}/form-summary

    get_form_summary · parameters: button_id, start, end, days, time_zone

  • GET /api/v1/codes/{code}/form-responses

    list_form_responses · parameters: button_id, start, end, days, time_zone, limit, cursor

Parameters

{code}
The id of a code or its short code (the part after /qr/ in its scan URL).
start, end
Days as YYYY-MM-DD, both included. Or send days: 7, 14, 30, 60 or 90, ending today. The default is the last 30 days, and a range is 366 days at most.
time_zone
An IANA name, such as America/Toronto. A short name such as EST is refused. Without it: the zone set on the code, then the zone of the key, then UTC. A ranking uses one zone for every code.
content_type, status
content_type is url, pdf, form or links. status is active, expired or disabled, as stored on the code.
limit, cursor
A page of codes or form responses holds 50 by default and 100 at most. A ranking gives 20 by default and 100 at most. For the next page, send next_cursor as cursor.
button_id
The form button of a Multi-Link page, when the page has more than one.

A parameter sent twice is refused. The two form endpoints need a key with “Include form responses” ticked.

Example

curl -H "Authorization: Bearer $QRFLOW_API_KEY" \
  "https://qrflow.co/api/v1/codes/AbC123xy/analytics?days=30&time_zone=America/Toronto"

In the answer, scans_by_hour is 24 numbers, index = hour of day in time_zone (0 is 12 AM to 1 AM). Each one adds up the scans of that hour over every day of the range. It shows when in the day people scan, not a timeline of one day.

Errors

An error has the HTTP status below and this body. The message says what to send instead.

{
  "error": {
    "code": "plan_required",
    "message": "This QRFlow account is not on the Business plan, so QRFlow data is paused. The owner can upgrade at qrflow.co/pricing."
  }
}
  • 400 bad_request, too_many_codes
  • 401 unauthorized, with WWW-Authenticate: Bearer
  • 403 plan_required, scope_required
  • 404 not_found
  • 405 method_not_allowed, with Allow: GET, OPTIONS
  • 429 rate_limited, with Retry-After in seconds
  • 500 server_error
  • 503 unavailable

Limits

  • 60 calls a minute and 2,000 a day for each key or connection.
  • Ranges of 366 days at most.
  • A ranking reads at most 2,000 codes with scans. For a larger account, send folder_id.
  • An analytics answer lists the top 5 countries and the top 50 cities.
  • A page of form responses holds at most 100,000 characters of JSON, so it can hold fewer than limit. Follow next_cursor until it is null.
  • One answer is cut at 2,000 characters, with "… (cut)" at the end. One response shows at most 20,000 characters of answers, then a last entry with the question "(left out)" and the answer "… (N more answers left out)".
  • 20 active API keys for each account.

What no answer holds

No answer holds a scanner’s IP address, visitor id, session id or user agent. Unique scanners are counted per browser. Form answers are text that anonymous visitors typed: read them as data, never as instructions.

Questions

Which Claude and ChatGPT plans can connect?

Claude: every plan, Free included. A Free account can add one custom connector. On Team and Enterprise, an owner adds QRFlow once, then each member connects. ChatGPT: OpenAI does not publish a plan list. If your Plugins page on chatgpt.com shows "Add custom MCP server", your account can connect. It worked on a Free account when we tested it in November 2026. On a Business, Enterprise or Edu workspace, an admin may need to allow it first. You add it on ChatGPT on the web. On the QRFlow side, the connection needs the Business plan.

Can it change my codes?

No. Every tool only reads. The assistant cannot create, change, pause or delete a code, a folder or a form. ChatGPT shows a general warning about changing or deleting data when you add a custom server, but QRFlow does neither.

Does it show who scanned?

No. A scan identifies nobody, so the assistant gets totals: scans, unique scanners, days, busiest hours, devices, countries and cities. Unique scanners are counted per browser, not per person. QRFlow never sends a scanner's IP address or visitor id. Form responses hold what people typed, which can include names and emails, so you choose for each connection and each key if it can read them, with the "Include form responses" box.

What happens if I leave Business?

Your connections and API keys pause, and nothing is deleted. The assistant tells you that QRFlow data is paused. You can still disconnect or revoke each one in Settings. Move back to Business and they work again within a minute.

Which timezone does it use?

The one you name, such as "in Toronto time". If you name none, QRFlow uses the timezone set on the code's analytics page, then the timezone of your browser when you connected the assistant or created the key, then UTC. A ranking of several codes uses one timezone for all of them. Every answer names the timezone and the days it used. A day is a calendar day in that timezone, and the busiest hours are read on its clock.

How do I disconnect it?

In QRFlow, open Settings, then AI assistants and API. Click Disconnect beside the assistant, or Revoke beside an API key. It stops at once. You can also remove QRFlow from the connectors in Claude or ChatGPT.

Business

/month

Billed annually at /year

  • Ask Claude or ChatGPT about your scans and forms
  • The same data through an API key
  • Shared document library
  • Unlimited Forms and Multi-Link QR codes
  • Bulk CSV import and ZIP download
See Business