Connect your AI assistant (MCP)

QR Top exposes an MCP (Model Context Protocol) server — the open standard Claude, ChatGPT, and most assistants use to operate external tools. Connected, your assistant can create QRs, change destinations, configure smart routing, and check stats — with your permission, scoped to your organization. Available on every plan.

The connector URL

https://qr-top.com/api/mcp

It's a remote server (Streamable HTTP transport): nothing to install. The recommended way to authenticate is the interactive login (OAuth) — the assistant opens your browser, you sign in with your QR Top account, done, no keys to copy.

Claude Code

Terminal

claude mcp add --transport http qr-top https://qr-top.com/api/mcp

Inside your session, run /mcp, select qr-top, and hit Authenticate: your browser opens with the QR Top login (you can create the account right there if you don't have one).

claude.ai and Claude Desktop

Settings → Connectors → Add custom connector, with the URL above. On connect, the QR Top login opens in a tab.

Cursor, Windsurf, and similar (with an API key)

For file-configured clients, use an API key (created under Settings → API in your account) in the Authorization header:

mcp.json

{
  "mcpServers": {
    "qr-top": {
      "url": "https://qr-top.com/api/mcp",
      "headers": { "Authorization": "Bearer qr_live_YOUR_KEY" }
    }
  }
}

Stdio-only clients

Via mcp-remote, which handles the OAuth flow for you:

Client configuration

{
  "mcpServers": {
    "qr-top": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://qr-top.com/api/mcp"]
    }
  }
}

What your assistant can do

Tool	What it does
list_links	Lists your links with scans, short URL, and status
create_link	Creates a dynamic QR — with smart routing, expiry, and UTMs if your plan includes them
update_link	Changes destination, title, status, or rules — immediate effect on printed QRs
delete_link	Deletes a link and its history (it will ask for confirmation)
get_link_stats	Analytics: totals, devices, and a 30-day daily series
get_account	Your plan, usage against limits, and available features

Example prompts

“Create a QR for each of the 20 tables, all pointing to the menu with ?table=N”
“Create a QR that shows the breakfast menu from 8 to 12, Madrid time, and the regular one the rest of the day”
“Which of my July QRs has the most scans? Compare them”
“Pause every link with no scans in the last 30 days”

Security and limits

The assistant only sees and modifies your organization's links, with the same plan and rate limits as the REST API.
OAuth access is tied to your session; API keys are revoked under Settings → API.
Deleting links is flagged as a destructive action: MCP clients ask for confirmation before running it.
Paid features (smart routing, custom slugs) return a clear message if your plan doesn't include them — the assistant will tell you.