<p align="center"><img src="assets/logo.png" width="120" alt="QR Cloud logo"></p>

# QR Cloud MCP Server

The official, hosted **Model Context Protocol (MCP) server** of [QR Cloud](https://qr-cloud.com) – the QR code marketing platform.
Let Claude, ChatGPT, Cursor, VS Code and other AI assistants create **dynamic QR codes** and **short links**, set up **QR Reviews** (a QR code that collects star ratings and sends happy guests to Google or Tripadvisor) and read your **scan, click and review statistics** – right from the chat.

> "Create a QR Review for my café that sends guests to our Google page, and make a QR code for the table stands."

- **Server URL (Streamable HTTP):** `https://qr-cloud.com/mcp`
- **Authentication:** OAuth 2.1 (sign in with QR Cloud, PKCE + dynamic client registration) or your API key as Bearer token
- **Docs:** https://qr-cloud.com/mcp-server/
- **Official MCP Registry:** `com.qr-cloud/qr-codes`
- **Requirements:** a QR Cloud account on a plan with API access ([pricing](https://qr-cloud.com/#pricing))

This repository contains documentation and listing metadata only. The server is operated by QR Cloud; there is nothing to install or self-host.

mcp-name: com.qr-cloud/qr-codes

## Connect

### Claude (claude.ai, Desktop, iOS/Android)
Settings → Connectors → **Add custom connector** → name `QR Cloud`, URL `https://qr-cloud.com/mcp` → **Connect** → sign in with QR Cloud → **Allow**.

### ChatGPT
Settings → Apps & Connectors → **Create** (developer mode) → URL `https://qr-cloud.com/mcp`, authentication **OAuth** → sign in → **Allow**.

### Claude Code
```bash
claude mcp add --transport http qr-cloud https://qr-cloud.com/mcp
```
Then run `/mcp` in Claude Code and choose **Authenticate**.

### Cursor
`~/.cursor/mcp.json`:
```json
{
  "mcpServers": {
    "qr-cloud": { "url": "https://qr-cloud.com/mcp" }
  }
}
```
Cursor opens the QR Cloud sign-in page automatically.

### VS Code
```json
{
  "servers": {
    "qr-cloud": { "type": "http", "url": "https://qr-cloud.com/mcp" }
  }
}
```

### Windsurf, Cline and other clients
Use the server URL `https://qr-cloud.com/mcp`. Clients without OAuth support can send your API key from [qr-cloud.com/account-api](https://qr-cloud.com/account-api):
```json
{
  "mcpServers": {
    "qr-cloud": {
      "url": "https://qr-cloud.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```
Clients that only speak stdio can bridge with `npx mcp-remote https://qr-cloud.com/mcp`.

## Tools

| Tool | What it does | Type |
| --- | --- | --- |
| `get_account` | Name, e-mail, plan and plan limits of the connected QR Cloud account. | read-only |
| `list_links` | List the user's links (short links, QR Pages/biolinks, file links ...), newest first. | read-only |
| `get_link` | Details of one link by link_id. | read-only |
| `create_short_link` | Create a short link that redirects to location_url. | write |
| `update_short_link` | Change destination (location_url), alias or enabled state of a short link. | write |
| `delete_link` | Permanently delete a link and its statistics. | destructive |
| `get_link_statistics` | Click statistics of a link. | read-only |
| `list_qr_codes` | List the user's QR codes with image URL (qr_code). | read-only |
| `create_qr_code` | Create a QR code for a URL or plain text. | write |
| `delete_qr_code` | Permanently delete a QR code. | destructive |
| `list_qr_reviews` | The user's QR Reviews (review funnels: happy customers go to Google etc., unhappy ones give private feedback) with public URL, views, ratings and average stars. | read-only |
| `get_qr_review` | One QR Review incl. | read-only |
| `create_qr_review` | Create a QR Review funnel. | write |
| `update_qr_review` | Change name, settings or enabled state of a QR Review. | write |
| `delete_qr_review` | Permanently delete a QR Review incl. | destructive |
| `get_qr_review_statistics` | Statistics of a QR Review for a period (default last 30 days): views, ratings, average stars, star distribution, outcomes (platform/feedback/thanks), top countries, per-day series and latest entries incl. | read-only |

Every tool carries MCP annotations (`readOnlyHint` / `destructiveHint`), so clients can ask before anything is changed or deleted.

## Example prompts

- "Shorten https://example.com/spring-sale as `spring` and give me a QR code in our brand blue #1E5EFF."
- "Set up a QR Review for Bella Vista Trattoria: 4–5 stars go to our Google page, lower ratings send feedback to me."
- "How many scans did my menu QR code get last week, and from which countries?"
- "Which of my short links had the most clicks this month?"

## Security & privacy

- OAuth 2.1 with PKCE, short-lived access tokens and rotating refresh tokens; tokens are stored hashed.
- See and disconnect connected AI apps anytime under [AI Assistants](https://qr-cloud.com/connected-apps).
- Privacy policy: https://qr-cloud.com/privacy-policy/

## Support

support@qr-cloud.com · https://qr-cloud.com

QR Cloud is a service of RiTZELMUt Ventures GmbH, Munich, Germany.