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.

Documentación

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

https://api.qrcake.com/mcp

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

ToolPermissionWhat it does
list_qr_codescodes.readList every QR code you own with its short link, destination and state.
get_qr_codecodes.readGet one of your QR codes by id.
get_plan_limitscodes.readYour plan tier, how many codes and active codes you use against their limits, whether analytics is included, and the custom domain limit.
create_qr_codecodes.writeCreate a dynamic QR code whose short link redirects to the given URL; your plan limits apply.
update_qr_codecodes.writeChange a QR code's destination, state, metadata or options without reprinting it; omitted fields keep their value.
create_file_uploadcodes.writeGet 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_codecodes.writeDelete a QR code permanently; its printed copies stop resolving.
design_qr_codecodes.read codes.writeOpen an interactive designer for one of your QR codes, to change its shapes, colors, logo and frame and save them.
get_qr_code_analyticsanalytics.readScan analytics for one QR code (interactions, locations, devices or geo, over a week, month or year). Needs a plan with analytics.
render_qr_codenoneRender any text or URL as a black-on-white QR code image (PNG) or SVG markup. Nothing is stored.
build_qr_contentnoneEncode 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_designnoneEstimate 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.

Open in GitBook

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.

Open in GitBook

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.

Open in GitBook

Path: /product

URL: https://api.qrcake.com/v1/product/api/product

  • x-api-key: <API Key>
  • Content-Type: application/json
  • Accept: 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).

Open in GitBook

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/json
  • Accept: 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.

Open in GitBook

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.

Open in GitBook

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.