# QRTap

> QRTap is a freemium MCP server for marketing and seo. Manage editable QR codes, short links, reviews and bookings from an AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://app.qrtap.kg/developers
- **Repository:** https://github.com/ilyashurf/qrtap-mcp
- **MCP Registry name:** io.github.IlyaShurf/qrtap
- **Categories:** marketing and SEO, developer tools
- **Listing updated:** 2026-11-15

## About

QRTap's idea is that the printed code never changes while the page behind it does. Each code encodes a permanent short link, and the destination is a separate, versioned record that can be edited later, so menus, stickers, packaging and business cards keep working after a change. This stdio server wraps the QRTap REST API v1 in twenty tools so an agent can do jobs like pointing a sticker at a new price list or issuing one code per branch.

Beyond codes, the API covers public business-card pages, a small inbox for guest reviews and booking requests, and conditional redirects by device, language or time. Scan analytics are anonymous and aggregated; the developer page says no IP address or user agent is stored. Every PNG is decoded again before it is served, and the server falls back to a plain code if branding hurt readability.

A workspace API key is required. The owner issues it in the QRTap cabinet, it is shown once, and it can be created on the free plan. Four of the tools change what real customers see and tell the agent to confirm first.

## Features

- **Editable destinations:** Change where a printed code leads without reprinting.
- **Bulk creation:** Create up to 500 codes in one call, idempotent by external reference.
- **Readability check:** PNG output is decoded back and downgraded to plain if branding breaks scanning.
- **Anonymous scan stats:** Per-code and per-group counts by day and device.
- **Reviews and bookings:** Read guest reviews and booking requests in the same workspace.
- **Confirmation on public changes:** Tools that alter public pages ask the agent to confirm with the user.

## Good for

- Point a menu or sticker QR at a new landing page
- Issue one code per branch or table with an external reference
- Check scan numbers for a campaign group
- Review new bookings and guest feedback from chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add qrtap --env QRTAP_API_KEY='<QRTAP_API_KEY>' -- npx -y qrtap-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "qrtap": {
      "command": "npx",
      "args": [
        "-y",
        "qrtap-mcp"
      ],
      "env": {
        "QRTAP_API_KEY": "<QRTAP_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qrtap": {
      "command": "npx",
      "args": [
        "-y",
        "qrtap-mcp"
      ],
      "env": {
        "QRTAP_API_KEY": "<QRTAP_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "qrtap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "qrtap-mcp"
      ],
      "env": {
        "QRTAP_API_KEY": "<QRTAP_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "qrtap": {
      "command": "npx",
      "args": [
        "-y",
        "qrtap-mcp"
      ],
      "env": {
        "QRTAP_API_KEY": "<QRTAP_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "qrtap": {
      "command": "npx",
      "args": [
        "-y",
        "qrtap-mcp"
      ],
      "env": {
        "QRTAP_API_KEY": "<QRTAP_API_KEY>"
      }
    }
  }
}
```

## Tools

- `qrtap_create_code`: Create a QR code and short link for a URL.
- `qrtap_create_codes_bulk`: Create up to 500 codes in one call with per-item results.
- `qrtap_list_codes`: List codes, filterable by group or external reference.
- `qrtap_get_code`: Fetch one code by id.
- `qrtap_change_destination`: Change where a code leads; affects the public.
- `qrtap_code_history`: Show a code's change history.
- `qrtap_create_short_link`: Create a short link for a URL.
- `qrtap_list_design_templates`: List available design templates.
- `qrtap_code_stats`: Read scan statistics for one code.
- `qrtap_group_stats`: Read scan statistics for a group.

## FAQ

### What does it need to run?

Node 20 or newer and a QRTAP_API_KEY from the workspace owner at app.qrtap.kg/workspace/api.

### Can I try it on the free plan?

Yes, a key can be issued on any plan including free; the plan changes limits and batch endpoints.

### Does it collect visitor data?

The developer page says scans are counted anonymously and neither IP nor user agent is stored.

### How many tools are there?

Twenty, mapped to the public REST API v1.

### Is QRTap free?

QRTap has a free plan, with paid plans for more usage or features.

### How do I add QRTap to Claude Code?

Run this command in your terminal: claude mcp add qrtap --env QRTAP_API_KEY='<QRTAP_API_KEY>' -- npx -y qrtap-mcp

### What are the best alternatives to QRTap?

The closest alternatives to QRTap are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/qrtap
