Help Center

How can we help?

Browse the qr64 user guide for step-by-step answers on account setup, QR code types, design, exporting, analytics, teams, and billing.

AI Assistants & MCP Server

The qr64 MCP server lets AI assistants and coding agents work with your qr64 account directly. Once connected, you can ask an assistant to create a QR code, change where it points, pause a campaign, or summarise scan analytics, and it does the work through qr64 on your behalf.

MCP (Model Context Protocol) is an open standard supported by tools such as Claude Code and Cursor. Any MCP client that can send a custom request header can connect.

1. What You Need

  • An active Enterprise plan. The MCP server uses developer API keys, which are an Enterprise feature. See the Plans & Billing Guide.
  • A developer API key. An account admin creates one under Developer Settings in the sidebar. The key starts with qrc_live_ and is shown only once, so copy it somewhere safe.

2. Connecting an Assistant

Point your MCP client at this address:

https://api.qr64.in/mcp

and send your API key with every request in this header:

Authorization: Bearer qrc_live_...

Claude Code

Run this once in your terminal, replacing the key with your own:

claude mcp add --transport http qr64 https://api.qr64.in/mcp --header "Authorization: Bearer qrc_live_..."

Cursor and Other Clients

Clients that are configured with a JSON file (for Cursor, .cursor/mcp.json) use an entry like this:

{
  "mcpServers": {
    "qr64": {
      "url": "https://api.qr64.in/mcp",
      "headers": {
        "Authorization": "Bearer qrc_live_..."
      }
    }
  }
}

Keep your key private. Anyone who has it can act on your account. Do not commit it to a code repository or share a config file that contains it. If a key is exposed, revoke it in Developer Settings and create a new one.

3. What an Assistant Can Do

ToolWhat it doesKey permission
get_accountShows your plan, the key's permissions, and how many dynamic QR codes you have leftAny key
create_dynamic_qrCreates a dynamic QR codeqrcodes:write
list_dynamic_qrsLists your dynamic QR codes with scan totalsqrcodes:read
get_dynamic_qrShows one QR code with its content and designqrcodes:read
update_dynamic_qrChanges the name, destination, status, folder or designqrcodes:write
delete_dynamic_qrPermanently deletes a QR code and its scan historyqrcodes:write
render_static_qrProduces a static QR code image (PNG or SVG) without saving itqrcodes:read
get_qr_analyticsReports scans by country, city, device, browser and dayanalytics:read

A key created with full access can use every tool. To give an assistant read-only access, create a key with only the qrcodes:read and analytics:read permissions.

Not sure whether you need a dynamic or a static code? See Static vs. Dynamic QR Codes.

4. Example Requests

  • “Create a dynamic QR code called Spring Menu that goes to https://example.com/menu and put it in the Menus folder.”
  • “Which of my QR codes got the most scans, and from which countries?”
  • “Point the Spring Menu code at https://example.com/summer-menu.”
  • “Pause every QR code in the Old Campaigns folder.”
  • “Give me a PNG QR code for https://example.com.”

5. Limits & Safety

  • Rate limit: 60 requests per minute per API key, shared with the REST developer API.
  • Plan quotas: QR codes created by an assistant count towards your plan's dynamic QR code limit.
  • Changes are live: Updating a destination redirects every printed copy of that code straight away.
  • Deleting is permanent: A deleted QR code stops working and its scan history cannot be recovered. To stop a code temporarily, ask the assistant to pause it instead.
  • Bulk generation is not available through the MCP server. Use the Bulk QR tool or the REST developer API.

6. Troubleshooting

What you seeWhat it means
401 UnauthorizedNo key was sent, or the key is mistyped, revoked or expired. Check the header, or create a new key.
403 Forbidden when connectingThe account is not on an active Enterprise plan.
A tool fails with 403The key does not have the permission that tool needs.
429 Too Many RequestsThe rate limit was reached. Wait a minute and try again.
“Dynamic QR code limit reached”Your plan's dynamic QR code quota is used up.

Return to the Help Center Overview to explore other topics.