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?
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.
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.
The top countries and cities, the share of scans from phones, and the languages of the browsers that scanned.
Count the options people picked, and read the newest answers. You choose if each connection can read form answers.
See which buttons on a link page get the taps, and the share of visitors who tapped one.
An API key gives Claude Code, Cursor, scripts and dashboards the same numbers as your analytics page.
In Claude, ChatGPT, Gemini or Grok, add a custom connector. The exact menus for each assistant are below.
Paste https://qrflow.co/mcp as the server address. The same address works in Claude and in ChatGPT.
Sign in to QRFlow and press Allow. Then ask about your codes. It can only read: it cannot change anything in QRFlow.
A ranking of your codes by scans in that month, with the all-time count beside each one.
Scans and unique scanners for each day, read in the code's own timezone.
The top countries and cities, and how many scans came from phones.
A count for each option, and the newest answers when you want to read them.
The exact menus for Claude, ChatGPT, Gemini, Grok and tools that take an API key.
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.
Type QRFlow as the Name. Paste this address as the MCP server URL, then click Add.
https://qrflow.co/mcpClick 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.
On ChatGPT on the web, open chatgpt.com/plugins. Open the Add menu at the top right, then click Add custom MCP server.
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/mcpThe Icon is optional. To show the QRFlow icon, download it here (PNG, 324 x 324 px, 7 KB).
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.
In Gemini, open Customize, then Connectors, and click + Custom.
Type QRFlow as the name and paste this address.
https://qrflow.co/mcpSign in to QRFlow. Check what Gemini can read, then click Allow. It can only read. It cannot create, change or delete anything.
In Grok, open your Profile, then Settings, then Connect Apps. Scroll down and click Add a custom connector.
Type QRFlow as the name and paste this address.
https://qrflow.co/mcpSign in to QRFlow. Check what Grok can read, then click Allow. It can only read. It cannot create, change or delete anything.
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.
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.
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.
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>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
A parameter sent twice is refused. The two form endpoints need a key with “Include form responses” ticked.
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.
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."
}
}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.
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.
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.
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.
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.
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.
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.
Billed annually at /year