QR Cake
QR Cake makes dynamic QR codes: the printed code stays the same while you change where it goes. Connect your account to create codes, repoint or pause them, restyle them, attach files and read scan analytics from a conversation.
Documentação
Create, update, and manage dynamic QR codes with the QR Cake API. Use API keys, test requests, and connect QR workflows to your own tools.
JSON REST APIDynamic QR CreationAPI key authMCP server
Quick Start
The QR Cake API lets QR Cake users manage their account QR Codes.
Base URL
https://api.qrcake.com/v1/product/api
Authentication
Create an API key in your dashboard and send it in the x-api-key header.
Each key carries permissions chosen when it is created (read QR codes, create and update QR codes, read scan analytics), and the full key is shown only once.
x-api-key: <API Key>
Content-Type: application/json
Manage API keys in Dashboard API Keys.
QR Code API Guide: Generating and Managing Codes Programmatically (2026)
MCP server for AI assistants
QR Cake also runs a remote MCP (Model Context Protocol) server, so Claude, Claude Code, Cursor and VS Code can list, create, update and delete your QR codes in a conversation. You connect by signing in to your QR Cake account.
Server URL
Resource metadata (RFC 9728)
https://api.qrcake.com/.well-known/oauth-protected-resource/mcp
Authentication
The client opens the QR Cake sign-in the first time it connects. Sign in, then approve what the client may do. No API key or password goes into the client; API keys work with the REST API only.
The tools a client can call depend on the permissions you approve. The three tools that need no permission are always available.
codes.read
Read QR codes and plan limits
codes.write
Create, update and delete QR codes
analytics.read
Read scan analytics (Pro and Business plans)
Tools
| Tool | Permission | What it does |
|---|---|---|
| list_qr_codes | codes.read | List every QR code you own with its short link, destination and state. |
| get_qr_code | codes.read | Get one of your QR codes by id. |
| get_plan_limits | codes.read | Your plan tier, how many codes and active codes you use against their limits, whether analytics is included, and the custom domain limit. |
| create_qr_code | codes.write | Create a dynamic QR code whose short link redirects to the given URL; your plan limits apply. |
| update_qr_code | codes.write | Change a QR code's destination, state, metadata or options without reprinting it; omitted fields keep their value. |
| create_file_upload | codes.write | Get an upload slot for a file (image, PDF, audio or video) to attach to a QR code. The client uploads the file itself. |
| delete_qr_code | codes.write | Delete a QR code permanently; its printed copies stop resolving. |
| design_qr_code | codes.read codes.write | Open an interactive designer for one of your QR codes, to change its shapes, colors, logo and frame and save them. |
| get_qr_code_analytics | analytics.read | Scan analytics for one QR code (interactions, locations, devices or geo, over a week, month or year). Needs a plan with analytics. |
| render_qr_code | none | Render any text or URL as a black-on-white QR code image (PNG) or SVG markup. Nothing is stored. |
| build_qr_content | none | Encode WiFi credentials, a contact card, an email, SMS, call, calendar event, location, crypto payment, WhatsApp, maps or FaceTime link as the text a QR code should carry. |
| analyze_qr_design | none | Estimate how much of each error-correction block a styled design (colors, module style, logo) consumes, with a healthy, fragile, critical or over-budget verdict. |
Connect a client
Claude, Claude Code, Cursor and VS Code can connect. Other clients are not accepted yet.
Claude
Add the server URL as a custom connector in Claude, then sign in when asked.
claude mcp add --transport http qrcake https://api.qrcake.com/mcp
Then run /mcp in Claude Code and sign in.
{
"mcpServers": {
"qrcake": {
"url": "https://api.qrcake.com/mcp"
}
}
}
{
"servers": {
"qrcake": {
"type": "http",
"url": "https://api.qrcake.com/mcp"
}
}
}
- Scan analytics is part of the Pro and Business plans; on the free plan get_qr_code_analytics answers with an error.
- Codes created through MCP count against your plan limits exactly as codes made in the dashboard.
- File, PDF, image, video and audio codes need an upload. A client that can make web requests, such as Claude Code or Cursor, can upload the file with create_file_upload; otherwise make those codes in the dashboard.
- In a client that supports MCP Apps, such as Claude, design_qr_code opens the designer inside the conversation. Other clients get the code as JSON.
- A connection lasts up to 30 days, after which the client asks you to sign in again.
API Request Tester
Test endpoints directly from this page. Enter your API key, select an endpoint, and inspect the live response.
Interactive API Tester
Run requests directly from your browser to the selected QR Cake API endpoint.
GET
x-api-key: YOUR_API_KEY
https://api.qrcake.com/v1/product/api/product
Run a request to see live status and response output here.
Terminology
Products
QR Codes
Users
QR Cake accounts
Request Bodies (POST/PUT)
For POST and PUT requests, request bodies must be stringified. If you are sending JSON, pass a JSON string (for example JSON.stringify(payload)).
const payload = { redirect: "https://example.com", metadata: {} };
await fetch(url, {
method: "POST",
body: JSON.stringify(payload),
});
GET
List QR Codes
Lists the QR Codes accessible to the API key.
Path: /product
URL: https://api.qrcake.com/v1/product/api/product
Request Details
Headers
x-api-key: <API Key>Accept: application/json
[
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
]
{
"message": {}
}
Products = QR Codes.
GET
Get a QR Code
Fetches one QR Code.
Path: /product/{productId}
URL: https://api.qrcake.com/v1/product/api/product/{productId}
Request Details
Path params
- productId (string)
Headers
x-api-key: <API Key>Accept: application/json
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
{
"message": {}
}
POST
Create a QR Code
Creates a new QR Code product.
Path: /product
URL: https://api.qrcake.com/v1/product/api/product
x-api-key: <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
{
"message": {}
}
POST request body must be stringified (for example, JSON.stringify(payload)).
PUT
Update a QR Code
Updates an existing QR Code (product).
Path: /product/{productId}
URL: https://api.qrcake.com/v1/product/api/product/{productId}
Request Details
Path params
- productId (string)
Headers
x-api-key: <API Key>Content-Type: application/jsonAccept: application/json
Body template
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"expiresAt": 0,
"createdAt": 0,
"updatedAt": 0
}
{
"message": {}
}
PUT request body must be stringified.
DELETE
Delete a QR Code
Deletes a QR Code.
Path: /product/{productId}
URL: https://api.qrcake.com/v1/product/api/product/{productId}
Request Details
Path params
- productId (string)
Headers
x-api-key: <API Key>Accept: application/json
{
"productId": "string"
}
{
"message": {}
}
GET
Permissions
Returns the permissions granted to the API key.
Path: /permission
URL: https://api.qrcake.com/v1/product/api/permission
Request Details
Headers
x-api-key: <API Key>Accept: application/json
{
"success": true,
"result": {
"tier": "subscriber",
"active": true,
"analytics": true,
"productLimit": 100,
"productTotal": 3,
"productActiveLimit": 100,
"productActiveTotal": 3
}
}
{
"message": {}
}
Supported QR Types
Use these metadata types when creating or updating QR products.
redirect, link, image, video, file, pdf, audio, app, event, vCard, review, email
Start with dynamic QR codes and changeable QR codes on our homepage.