TheQRCode.io MCP server

TheQRCode.io MCP Server

Generate QR codes — and read their scan analytics — from Claude, Cursor, or any MCP client.

Remote HTTP server. Nothing to install. No npm, no Docker, no Python. Point your client at one URL and ask.

https://mcp.theqrcode.io/mcp

Listed in the official MCP Registry as io.theqrcode/qr-code-generator.

Setup

Claude Desktop

Settings → Developer → Edit Config:

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

With an API key (unlocks the analytics tools)

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Any client supporting the MCP spec over streamable HTTP works. Restart the client after editing config, then just ask: "Generate a QR code for https://example.com".

Tools

Three tools. All three are advertised to every session — including anonymous ones, so directory crawlers see the real surface — but the two account tools refuse at call time without a key.

generateqrcode — free, no key

Returns a hosted image URL plus a base64 data URL for inline display. svg and pdf come back as a data URL in the text response rather than an image block, since a PDF is not one and many clients will not draw an SVG one.

Every design option is free, on every plan and with no key at all — colour, size, dot and corner styling, frames and captions, with no watermark on any output. What the paid plans sell is dynamic codes, analytics, stored-code volume and the managed API. Logo embedding is free too but is not a parameter here: it needs a base64 data URL, which is a poor fit for a tool call.

format: "svg" | "pdf" is the one asymmetry, and it is a cost control rather than a paywall: vector and PDF are the most expensive render path, so they are metered per key instead of per IP. Both are free in the dashboard and in the no-signup generator on theqrcode.io, on every plan.

Anonymous → the public keyless API, 100 requests/hour per IP. The hosted link is a 24-hour preview; download the image rather than bookmarking the URL. The QR code itself never expires — it is the preview hosting that is temporary.

Authenticated → the v1 API. The code is saved to your account permanently, rate limited by key rather than IP, and format: "svg" | "pdf" becomes available.

listqrcodes — Developer plan

Lists codes saved to your account. page, limit (1–100), type filter.

get_analytics — Developer plan

Scan analytics, account-wide or for one qrCodeId. timeRange: 1h, 1d, 7d, 30d (default), 90d, 1y.

Shortened. The full README is on GitHub.