Docs

MCP server and API.

Works with Claude & ChatGPT (MCP). Create short links and QR codes, change destinations and read stats from an AI assistant or your own code.

What you need

A paid plan (Pro, Business or Agency). Claude and ChatGPT on the web and on mobile connect by signing in to QRlanza (OAuth), with no key to copy. For Claude Desktop, Claude Code and your own code, use an API key: in the dashboard, Settings → API keys. Only the workspace owner can connect apps or create keys. The Free plan does not include the API or the MCP server.

PlanCalls a day (REST + MCP)
Pro1,000
Business5,000
Agency20,000

Each REST request and each MCP tool call counts as one. The count resets at 00:00 UTC.

MCP server

Remote server, Streamable HTTP: https://qrlanza.com/api/mcp. It accepts an OAuth access token (from connecting in Claude or ChatGPT) or an API key in Authorization: Bearer qrw_…. Both use the same workspace and the same daily calls.

Tools

The same checks as the dashboard apply: unsafe destinations (Google Web Risk) are refused, and plan and write limits count.

claude.ai (web and mobile)

  1. In claude.ai, open Settings → Connectors → Add custom connector.
  2. Name it QRlanza and paste the URL https://qrlanza.com/api/mcp. Leave the OAuth fields empty.
  3. Click Connect, sign in to QRlanza and choose Allow. If you own several workspaces, pick the one Claude will use.

The connector then works in the Claude apps for iPhone and Android too.

ChatGPT

  1. In ChatGPT, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode (on plans that offer custom connectors).
  2. Back in Apps & Connectors, choose Create, name it QRlanza, paste https://qrlanza.com/api/mcp and set Authentication to OAuth.
  3. Sign in to QRlanza and choose Allow.

Disconnect

In Settings → Connected apps, Revoke cuts the app off at once. Access tokens last one hour and renew on their own for 30 days of use.

Claude Desktop and Claude Code (with a key)

claude mcp add --transport http qrlanza https://qrlanza.com/api/mcp \
  --header "Authorization: Bearer qrw_…"

In Claude Desktop, add it to claude_desktop_config.json:

{
  "mcpServers": {
    "qrlanza": {
      "command": "npx",
      "args": ["mcp-remote", "https://qrlanza.com/api/mcp",
               "--header", "Authorization: Bearer qrw_…"]
    }
  }
}

For developers

OAuth 2.1 with PKCE (S256) and dynamic client registration. Discovery: https://qrlanza.com/.well-known/oauth-protected-resource and https://qrlanza.com/.well-known/oauth-authorization-server. Without credentials, /api/mcp answers 401 with WWW-Authenticate pointing to the resource metadata.

REST API

curl https://qrlanza.com/api/v1/links \
  -H "Authorization: Bearer qrw_…" \
  -H "Content-Type: application/json" \
  -d '{"destination":"https://yourbrand.com/summer","slug":"summer","qr":true}'

GET and POST /api/v1/links; GET, PATCH and DELETE /api/v1/links/<id>. Add "host" to use a verified domain. Limits by plan on the pricing page.