# QRTap

> QRTap (https://app.qrtap.kg) is a managed QR code, short link and public-page platform
> from Kyrgyzstan. Every code encodes a stable short URL; the destination behind it can be
> changed at any time via the REST API without reprinting. Scan analytics are aggregated
> and anonymous (no visitor IP or user-agent is ever stored).

Кратко по-русски: QRTap — платформа управляемых QR-кодов, коротких ссылок и
страниц-визиток. Код кодирует постоянную короткую ссылку; назначение меняется через API
без перепечатки тиража. Через API можно собрать клиенту страницу, забрать отзывы и заявки
на запись, настроить умные правила редиректа. Статистика сканов анонимная и агрегированная.

## What the API can do

- Create managed QR codes / short links (single or bulk up to 500, idempotent by external_ref)
- Change a code's destination without reprinting (PATCH; full destination history kept)
- Build and publish a customer's public page (business card at /a/{slug}) and point a QR at it
- Work the mini-CRM inboxes: guest reviews (moderate: publish/hide) and booking requests
  (confirm/decline)
- Set smart redirect rules per code: by device, language or local hours (first match wins)
- Read anonymous scan stats per code and per group (totals, per-day, device split)
- Render artifacts: decode-verified PNG, true-vector SVG, print PDF; branded via design templates
- Real-time scan webhooks with HMAC-SHA256 signatures and retries

Auth: `Authorization: Bearer <key>` — keys are per organization. Issue one yourself in
the workspace at https://app.qrtap.kg/workspace/api (paid plan, workspace owner); the
full key is shown once at issue time. Questions: https://app.qrtap.kg/support

Rate limit: 120 requests per minute per API key on every /api/v1 endpoint; over the limit
the API answers 429 with a Retry-After header (webhook management routes are exempt).

## Docs

- [Developer documentation](https://app.qrtap.kg/developers): quick start, pages, reviews, bookings, smart rules, webhooks, errors
- [OpenAPI 3.1 specification](https://app.qrtap.kg/openapi.json): full machine-readable spec of API v1
- [Extended capability description for LLMs](https://app.qrtap.kg/llms-full.txt)

## MCP for AI agents

QRTap ships an MCP (Model Context Protocol) stdio server (npm: qrtap-mcp) exposing tools:
qrtap_create_code, qrtap_list_codes, qrtap_change_destination, qrtap_code_stats,
qrtap_create_short_link, qrtap_create_page, qrtap_update_page, qrtap_list_pages,
qrtap_list_reviews, qrtap_moderate_review, qrtap_list_bookings, qrtap_set_booking_status,
qrtap_set_smart_rules. Configuration (Claude Desktop / Claude Code) and setup:
https://app.qrtap.kg/developers — env: QRTAP_API_KEY, QRTAP_API_URL.