Qrblox MCP
OfficialThis server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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.
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 |
| Confirm reachability + identity. |
| The merchant workspace attached to the key. |
| List recent QR codes. |
| Create a draft QR code (URL, menu, offer, campaign). |
| Draft an audio code (near-ultrasonic payload). |
| Build and extend merchant menus. |
| Scan streaks, scan-count games, visit-window or loyalty campaigns. |
| Total scans + by-day series. |
Plus two REST endpoints for non-MCP callers:
Endpoint | Auth | Notes |
| none | 3 / IP / day, sandbox, 7-day expiry. |
|
| Up to 50 permanent codes per call, written to your merchant workspace. |
Discovery
URL | What it returns |
| Server info + the full tool list (no auth). |
| JSON-RPC tool discovery (no auth). |
| Public manifest: endpoint shape, limits, upgrade path. |
Full reference and connect snippets at docs.qrblox.com/mcp.html.
Errors
HTTP / JSON-RPC | Meaning |
| Invalid JSON-RPC 2.0 request. |
| Missing or invalid key. |
| Key revoked ( |
| Unsupported method. |
| Unknown tool. |
| Tool handler threw β read |
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
π qrblox.com β marketing site
π₯οΈ app.qrblox.com β web dashboard
π Full Qrblox docs
π Terahertz-Inc/qrblox-com β Qrblox overview repo
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
Create and manage dynamic QR codes and read their scan analytics from Claude and other MCP clients.
Create and edit dynamic QR codes from AI assistants via the QRay agent MCP endpoint.
Create dynamic QR codes, change where they go and read scan stats from your AI assistant.
Create and update dynamic QR codes, change their destinations, and read scan analytics.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT
- AlicenseNot gradedqualityCmaintenanceLets 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
- AlicenseAqualityCmaintenanceEnables 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.2068 npmMIT
- FlicenseNot gradedqualityAmaintenanceEnables 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.-