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/mcpand 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
| Tool | What it does | Key permission |
|---|---|---|
get_account | Shows your plan, the key's permissions, and how many dynamic QR codes you have left | Any key |
create_dynamic_qr | Creates a dynamic QR code | qrcodes:write |
list_dynamic_qrs | Lists your dynamic QR codes with scan totals | qrcodes:read |
get_dynamic_qr | Shows one QR code with its content and design | qrcodes:read |
update_dynamic_qr | Changes the name, destination, status, folder or design | qrcodes:write |
delete_dynamic_qr | Permanently deletes a QR code and its scan history | qrcodes:write |
render_static_qr | Produces a static QR code image (PNG or SVG) without saving it | qrcodes:read |
get_qr_analytics | Reports scans by country, city, device, browser and day | analytics: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 see | What it means |
|---|---|
| 401 Unauthorized | No key was sent, or the key is mistyped, revoked or expired. Check the header, or create a new key. |
| 403 Forbidden when connecting | The account is not on an active Enterprise plan. |
| A tool fails with 403 | The key does not have the permission that tool needs. |
| 429 Too Many Requests | The 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.