QRTap

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ilyashurf-qrtap

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

10 read · 7 write · 0 delete · 3 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (20)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• qrtap_change_destination

  Point an existing code at a new destination URL. This is the core of the product: the printed QR, its slug and its short_url stay byte-for-byte the same, only the redirect target changes, so a menu or price list can be replaced without reprinting anything. The change is live for the next scan, immediately, and the previous destination is kept in the audit trail (qrtap_code_history). Because it changes what real customers see, confirm the new URL with the user before calling.

• qrtap_code_history

  Every destination one code has ever pointed at, newest first, with the version number, the reason and when each became active. Use it to answer 'where did this code point last week?' or to recover a previous URL after a wrong retarget. The printed code itself never changed — only its target did.

• qrtap_code_stats

  Aggregated anonymous scan statistics for ONE code: total scans, a per-day series and the device split (mobile/tablet/desktop). Bots are excluded; QRTap stores no visitor IPs or user-agents, so no per-person data exists to return. Bound the window with `from`/`to` when the user asks about a period. For a whole batch use qrtap_group_stats; for plain totals across many codes use qrtap_list_codes with include_stats.

• qrtap_create_code

  Create ONE managed QR code on QRTap. Returns the code object: `id`, `short_url` (the stable link the QR actually encodes — printing this once is safe because it never changes), `png_url`/`svg_url` for the rendered artifact, plus the label/group/external_ref you set. The destination behind the code is editable forever via qrtap_change_destination, so the printed sticker never has to be reissued. For more than a handful of codes at once use qrtap_create_codes_bulk instead — it is one request rather than N.

• qrtap_create_codes_bulk

  Create MANY managed codes in a single request — up to 500. Use this for any batch: stickers for a print run, one code per table or shelf, one per branch or partner. Results are per item, so one bad URL does not sink the batch: the reply is {created, reused, failed, data:[…]} where each entry is either a code (ok=true, plus `reused` telling you whether it already existed) or {ok:false, external_ref, error}. On a re-run after a partial failure `created` counts only what was actually new and `reused` counts what was returned unchanged, so the two numbers tell you whether the call did any work. Gi…

• qrtap_create_page

  Create and publish the organization's public page — a mobile business card served at https://app.qrtap.kg/a/<slug> with the name, contacts, price list and review links. Returns `slug` and `public_url`; feed that public_url to qrtap_create_code to get a printable card. WARNING: a workspace has exactly ONE page, and if one already exists this REPLACES its whole content with what you send. Every field you leave out is dropped from the live page. Never reach for this tool to add or change something on a page that exists: call qrtap_get_page first, merge your change into the content it returns, and…

• qrtap_create_short_link

  Create a short link (https://app.qrtap.kg/<slug>) when the user asks for a LINK rather than a printed code. It is the same managed object as a QR code and hits the same endpoint as qrtap_create_code — the reply's short_url is permanent, the destination is retargetable, scans are counted. Pick this one only when the user wants nothing but a link; if they need a label, a group, an external_ref or a batch, use qrtap_create_code / qrtap_create_codes_bulk, which take those fields.

• qrtap_get_code

  Fetch one code by id: its current destination, label, group, external_ref, the permanent short_url and the artifact URLs. Use it to confirm where a code points right now before changing it, or to re-read a code returned earlier.

• qrtap_get_page

  Read ONE public page in full, including its current `content` object. This is the read-before-write step for qrtap_update_page, which overwrites content wholesale — fetch here, change the one field, send the merged object back. qrtap_list_pages deliberately omits content, so it cannot be used for this.

• qrtap_get_smart_rules

  Read the conditional (Smart Links) redirect rules currently set on one code. An empty array means the code always goes to its primary destination. Call this before qrtap_set_smart_rules, which replaces the whole rule set — otherwise you will silently drop rules you did not know about.

• qrtap_group_stats

  Aggregated scan statistics for a WHOLE group of codes at once: how many codes are in the group plus the combined total, per-day series and device split. This is the report for a batch — all branches, all tables, all partner stickers — without iterating over codes one by one.

• qrtap_list_bookings

  List booking requests left by guests on the organization's public pages, newest first: service, the guest's free-form preferred time, name, phone and status. status='new' is the inbox that still needs a decision — that is the usual call. Omit status to see everything. The reply contains customers' names and phone numbers, so treat it as personal data: use it to serve the request, do not copy it elsewhere.

• qrtap_list_codes

  List the organization's managed codes and short links, newest first. This is the way to find a code's `id` before retargeting it, and the way to check what already exists before creating more. Filter by `group` (a whole batch) or `external_ref` (one specific code). Set include_stats=true to get every code's all-time scan count in the same response — far cheaper than calling qrtap_code_stats per code when you only need totals.

• qrtap_list_design_templates

  List the organization's branded design templates (brand colour, centre logo, default caption), newest first. Its only purpose is to get a `design_template_id` to pass to qrtap_create_code / qrtap_create_codes_bulk. Templates are created by the owner in the cabinet, not through this server, because they carry logo image data.

• qrtap_list_pages

  List the organization's public pages — slug, segment, theme, published state, version and public_url. Content is NOT included; use qrtap_get_page to read it. Use this when you only need to discover the slug or check whether a page exists yet.

Signals

Stars

0

Forks

0

Open issues

0

Last commit

Oct 16, 2026 (12 days ago)

Last release

Oct 16, 2026 (12 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.IlyaShurf/qrtap

Version

1.0.4

Auth

API key

Packages

npm qrtap-mcp

License

MIT

Repository

github.com/IlyaShurf/qrtap-mcp

Website

app.qrtap.kg/developers

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql