Qrblox

com.qrbloxPublished by qrblox.comOfficial publisherv0.1.0Updated Oct 27, 2026

Create and track QR codes, audio codes, menus, and scan analytics for a Qrblox merchant.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & CommerceMedia & Design

Overview

AI-generated overview

Qrblox MCP lets an assistant create and manage QR codes, audio codes, menus and scan campaigns, and read scan analytics for a Qrblox merchant workspace.

What you can do
  • Check server reachability and read the merchant workspace profile attached to the key
  • List, create and edit QR codes, including re-pointing dynamic destinations, scan sounds and names
  • Create draft audio codes and build merchant menus with sections and items
  • Create draft scan challenges, streaks, games and loyalty campaigns
  • Summarize scan activity and pull per-code reports with daily counts and scan locations
When to use it
Useful when a merchant wants an assistant to draft QR codes, menus or scan-based loyalty campaigns on their Qrblox account, or to review how existing codes are being scanned, without leaving the chat client.
Requirements
A Qrblox merchant account and an sk-qrblox- API key, sent as a bearer token in the Authorization header or set as QRBLOX_API_KEY for the local npm package. Works as a remote endpoint or a local stdio process; network access is needed.
Before you install
The API key grants access to one merchant workspace, so treat it as a secret and revoke it if exposed. Creation tools write to the account, though the README describes them as draft-first with publishing left to the merchant. Scan analytics include per-scan dates and city/state, and registering a voice agent publishes a public directory page for the domain.

Installation

In SourceWeft

  1. Open Qrblox in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.qrblox%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "qrblox": {
      "type": "http",
      "url": "https://api.qrblox.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Qrblox MCP

The Model Context Protocol server for Qrblox — let any MCP-aware AI agent generate and manage QR codes, audio codes, menus, and loyalty campaigns.

📚 Full reference: docs.qrblox.com/mcp.html 🌐 Endpoint: https://app.qrblox.com/api/mcp 🔑 Mint a key: create.qrblox.com/settings/api-keys 🟢 No-key sandbox: POST https://app.qrblox.com/api/generate-qr-code

This is a public, README-only repo. The MCP server itself is deployed at the endpoint above; the canonical docs live at docs.qrblox.com/mcp.html.

What is it?

qrblox-mcp is a JSON-RPC 2.0 MCP server. Point Claude Desktop, Cursor, Codex, or any MCP client at https://app.qrblox.com/api/mcp, paste in a sk-qrblox- key, and the assistant can immediately draft QR codes (and audio codes, menus, and loyalty campaigns) and read scan analytics on a merchant workspace.

Every code created via the MCP lives on the caller's Qrblox account alongside codes made from the iOS, Android, Canva, and web surfaces.

Quick start

1. Try it free (no signup, no OAuth)

bash
curl -X POST https://app.qrblox.com/api/generate-qr-code \  -H 'content-type: application/json' \  -d '{"url":"https://example.com"}'

Returns:

jsonc
{  "ok": true,  "code": {    "codeId": "…",    "destinationUrl": "https://example.com",    "qrImage":    "data:image/png;base64,…",            // inline PNG    "qrImageUrl": "https://storage.googleapis.com/…",    // hosted PNG    "claimToken": "…",    "expiresAt":  "…"  },  "upgrade": { "signup": "https://app.qrblox.com", "apiKeys": "https://create.qrblox.com/settings/api-keys" }}

Sandbox limits: 3 codes / IP / day, codes expire in 7 days.

2. Mint an API key

Sign in to create.qrblox.com → Settings → API keys → New API key. Keys are sk-qrblox-<64 hex chars>, shown once, and revocable anytime.

3. Connect Claude Desktop

jsonc
// ~/Library/Application Support/Claude/claude_desktop_config.json{  "mcpServers": {    "qrblox": {      "url": "https://app.qrblox.com/api/mcp",      "headers": {        "Authorization": "Bearer sk-qrblox-..."      }    }  }}

Restart Claude Desktop. Then ask: "Generate a QR code for https://my-spring-menu.com."

4. Or Cursor / Codex / curl

Same URL, same Authorization header.

bash
# tools/list — no auth requiredcurl -X POST https://app.qrblox.com/api/mcp \  -H 'content-type: application/json' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# tools/call — create a code on your accountcurl -X POST https://app.qrblox.com/api/mcp \  -H 'authorization: Bearer sk-qrblox-...' \  -H 'content-type: application/json' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",       "params":{"name":"qrblox.qr.create",                 "arguments":{"title":"Spring menu",                              "destinationUrl":"https://qrblox.com/menu/spring"}}}'

Tools

All tools are merchant-scoped and draft-first — agents propose, the merchant approves before publishing.

ToolDescription
qrblox.pingConfirm reachability + identity.
qrblox.merchant.get_profileThe merchant workspace attached to the key.
qrblox.qr.listList recent QR codes.
qrblox.qr.createCreate a draft QR code (URL, menu, offer, campaign).
qrblox.audio.createDraft an audio code (near-ultrasonic payload).
qrblox.menu.create / .list / .add_itemBuild and extend merchant menus.
qrblox.challenge.createScan streaks, scan-count games, visit-window or loyalty campaigns.
qrblox.analytics.scan_summaryTotal scans + by-day series.

Plus two REST endpoints for non-MCP callers:

EndpointAuthNotes
POST /api/generate-qr-codenone3 / IP / day, sandbox, 7-day expiry.
POST /api/bulk-qr-codesBearer sk-qrblox-...Up to 50 permanent codes per call, written to your merchant workspace.

Discovery

URLWhat it returns
GET https://app.qrblox.com/api/mcpServer info + the full tool list (no auth).
POST https://app.qrblox.com/api/mcp tools/listJSON-RPC tool discovery (no auth).
GET https://app.qrblox.com/api/generate-qr-codePublic manifest: endpoint shape, limits, upgrade path.

Full reference and connect snippets at docs.qrblox.com/mcp.html.

Errors

HTTP / JSON-RPCMeaning
400 / -32600Invalid JSON-RPC 2.0 request.
401 / -32001Missing or invalid key. data.code = NO_AUTH / INVALID_API_KEY / INVALID_TOKEN.
403 / -32001Key revoked (data.code = REVOKED).
200 / -32601Unsupported method.
200 / -32602Unknown tool.
200 / -32000Tool handler threw — read error.message.

Security model

  • Merchant-scoped — every API key is tied to one merchant workspace and one owner uid; tools can't reach another merchant's data.
  • Hashed keys — plaintext shown once; Firestore stores only a SHA-256 hash and a short prefix.
  • Audited — every tool call writes an audit entry with the caller, tool name, and status. Arguments and results are not persisted.
  • Draft-first — creation tools produce drafts; publishing, billing, and destructive changes stay with the merchant.

Related

License

© Qrblox / Terahertz Inc.

Source: README.md at commit 058e34a

Tools

14

qrblox.ping

Confirm that the Qrblox MCP server is reachable for the authenticated merchant.

Takes no parameters.

qrblox.voice_agent.lookup

Look up a business in the Qrblox Voice Agent Phone Book by website domain — returns their confirmed AI voice agent phone number if registered.

Parametersdomainrequired

qrblox.voice_agent.register

Register a business's AI voice agent phone number and domain in the Qrblox Voice Agent Phone Book directory (free; creates a backlink page at qrblox.com/d/<domain> once approved).

ParametersemailrequireddomainrequiredbusinessNamerequiredvoiceAgentPhonerequired

qrblox.merchant.get_profile

Get the merchant workspace attached to this user or API key.

Takes no parameters.

qrblox.qr.list

List recent QR codes for the merchant.

Parameterslimit

qrblox.qr.create

Create a finished QR code: returns a hosted PNG (qrImageUrl) plus, for dynamic codes, a qrb.dev dynamic link you can re-point later. Options: template wraps the code in a Qrblox hex frame; boostFrame renders a scan-to-earn reward frame (scans through the Qrblox app award boosted points); scanBeepSound makes the Qrblox app play that sound on every scan (forces dynamic). Plain calls with none of these return a simple static code.

ParameterstagstitlerequireddynamiccampaigntemplateboostFramescanBeepSounddestinationUrlrequired

qrblox.qr.update

Edit an existing QR code: re-point the destination URL (dynamic codes redirect immediately, no reprint), change the scan sound, or rename it. Identify the code by codeId (from qr.create/qr.list) or uniqueQRCodeID.

ParameterstitlecodeIdscanBeepSounddestinationUrluniqueQRCodeID

qrblox.qr.get_analytics

Per-code scan report from the Qrblox analytics pipeline: total scans, daily counts, and every scan with date and city/state. Works for dynamic codes and app-scanned codes (last 365 days max).

ParametersdayscodeIduniqueQRCodeID

qrblox.audio.create

Create a draft audio code payload that can later be published as a near-ultrasonic sharing experience.

ParameterstitlerequiredcampaignpayloadTextrequired

qrblox.menu.create

Create a merchant menu that can be connected to QR codes, audio codes, and scan experiences.

ParametersnamerequiredlocationIddescription

qrblox.menu.list

List recent menus for the merchant.

Parameterslimit

qrblox.menu.add_item

Add an item to a section in an existing merchant menu.

ParametersnamerequiredpricemenuIdrequireddescriptionsectionNamerequired

qrblox.challenge.create

Create a draft scan challenge, streak, game, or loyalty campaign.

ParametersnamerequiredendsAtstartsAtrewardTextdescriptionchallengeTyperequired

qrblox.analytics.scan_summary

Summarize recent scan activity for a merchant workspace.

Parametersdays

Version history

1
  1. v0.1.0LatestOct 15, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts