Skip to main content
Glama
Qrblox MCP

Qrblox MCP

Official

Qrblox MCP

npm MCP Registry License: MIT

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.


Related MCP server: QRSalt MCP server

Quick start

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

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

Returns:

{
  "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

// ~/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.

# tools/list β€” no auth required
curl -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 account
curl -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.

Tool

Description

qrblox.ping

Confirm reachability + identity.

qrblox.merchant.get_profile

The merchant workspace attached to the key.

qrblox.qr.list

List recent QR codes.

qrblox.qr.create

Create a draft QR code (URL, menu, offer, campaign).

qrblox.audio.create

Draft an audio code (near-ultrasonic payload).

qrblox.menu.create / .list / .add_item

Build and extend merchant menus.

qrblox.challenge.create

Scan streaks, scan-count games, visit-window or loyalty campaigns.

qrblox.analytics.scan_summary

Total scans + by-day series.

Plus two REST endpoints for non-MCP callers:

Endpoint

Auth

Notes

POST /api/generate-qr-code

none

3 / IP / day, sandbox, 7-day expiry.

POST /api/bulk-qr-codes

Bearer sk-qrblox-...

Up to 50 permanent codes per call, written to your merchant workspace.


Discovery

URL

What it returns

GET https://app.qrblox.com/api/mcp

Server info + the full tool list (no auth).

POST https://app.qrblox.com/api/mcp tools/list

JSON-RPC tool discovery (no auth).

GET https://app.qrblox.com/api/generate-qr-code

Public manifest: endpoint shape, limits, upgrade path.

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


Errors

HTTP / JSON-RPC

Meaning

400 / -32600

Invalid JSON-RPC 2.0 request.

401 / -32001

Missing or invalid key. data.code = NO_AUTH / INVALID_API_KEY / INVALID_TOKEN.

403 / -32001

Key revoked (data.code = REVOKED).

200 / -32601

Unsupported method.

200 / -32602

Unknown tool.

200 / -32000

Tool 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.



License

Β© Qrblox / Terahertz Inc.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables creating and managing QR codes, short links, landing pages, and forms through natural language in any MCP client, including analytics and dynamic PDF codes.
      71 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets an AI assistant create QR codes and short links, re-point or pause them, inspect scan counts and analytics, and read the contents of a QR image you supply. It connects to a hosted workspace over Streamable HTTP, so codes can be managed and tracked without leaving the chat.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to run a QRTap workspace end to end: create and edit QR codes and short links, publish public pages, moderate guest reviews, manage booking requests, and configure conditional redirects, with anonymous scan analytics. It also supports bulk code issuance and print-ready PNG, SVG, and PDF artifacts.
      20
      68 npm
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI coding agents and MCP hosts to register a workspace, create stablecoin checkout and payment links, configure webhooks, verify crypto payment status, and add webhook-based access logic to applications.
      -