How do I install TheQRCode.io?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does TheQRCode.io need an API key?

No required environment variable is listed on this record.

What transport does TheQRCode.io use?

TheQRCode.io is reached over HTTP.

When was TheQRCode.io last checked?

Last checked 2026-11-10. Free styled QR codes, no key: URL, WiFi, contact, text, email. API key adds saved codes + analytics.

TheQRCode.io MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.theqrcode.io/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.theqrcode-qr-code-generator https://mcp.theqrcode.io/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.theqrcode-qr-code-generator": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.theqrcode.io/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.5.2
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.

`generate_qr_code` — free, no key

Param	Type	Required	Notes
`type`	`url` \| `wifi` \| `contact` \| `text` \| `email`	yes	all five free, no key
`content`	string	yes	the data to encode
`name`	string	no	display name when saving to an account
`size`	int 64–1024	no	default 256
`darkColor`	`#RRGGBB`	no	default `#000000`
`lightColor`	`#RRGGBB`	no	default `#FFFFFF`
`dotStyle`	`square` \| `dots` \| `rounded` \| `extra-rounded` \| `classy` \| `classy-rounded`	no	module shape
`cornerStyle`	`square` \| `dot` \| `extra-rounded`	no	the three corner squares
`frameStyle`	`square` \| `rounded` \| `circle` \| `dashed`	no	`square` means no frame
`caption`	string ≤60	no	text under the code; implies a frame
`format`	`png` \| `svg` \| `pdf`	no	default `png`; svg/pdf need a 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.

`list_qr_codes` — 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.

Returns total and unique scans, time, approximate location (country/city derived from IP — regional, not GPS), device and OS, and campaign. Static QR codes cannot be tracked; analytics require a dynamic code.

Plans

	Anonymous	Developer ($19/mo)	Pro ($29/mo)
`generate_qr_code`	✅ all 5 types, full design	✅ + svg/pdf output	✅ + svg/pdf output
Codes saved to account	❌ 24h preview link	✅ permanent	✅ permanent
`list_qr_codes`	❌	✅	❌
`get_analytics`	❌	✅	❌
MCP rate limit	100/hr per IP	2,000/hr per key	500/hr per key

MCP calls also count toward the key's 5,000/hr REST API limit; the MCP limit is a cap within it.

API keys: https://theqrcode.io/pricing

Running it yourself

The hosted server at mcp.theqrcode.io is the supported path — you do not need to run this. But it is a plain Express app if you want to:

npm install
npm run build
npm run start:http # HTTP server on $PORT (or: npm run dev)
npm start          # one session over stdio, for a local client
npm test

Over stdio, set THEQRCODE_API_KEY to unlock the account tools; without it you get the keyless set.

Env	Default	Purpose
`QR_API_BASE`	`https://theqrcode.io`	REST API this server wraps
`PORT`	`3001`	listen port (HTTP mode)
`THEQRCODE_API_KEY`	—	API key for stdio mode (HTTP takes it per request as a Bearer token)

Routes: POST|GET|DELETE /mcp (stateless — a fresh server and transport per request), GET /health.

Docker:

docker build -t theqrcode-mcp .
docker run -p 3001:3000 -e PORT=3000 theqrcode-mcp

What it wraps

TheQRCode.io is a QR code generation and analytics platform: static and dynamic QR codes for URLs, WiFi, vCard contacts, text and email, with scan analytics by time, device and approximate location. Static codes never expire, printed codes are never switched off to force an upgrade, and the design of a code is never billed for.

This server is one of three ways in — the others are a keyless REST API and OpenAI function calling.

Site — https://theqrcode.io
REST API — https://theqrcode.io/qr-code-api
OpenAPI spec — https://theqrcode.io/api/public/qr-codes/openapi.json
Agent guide — https://theqrcode.io/llms-full.txt

License

MIT — see LICENSE.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install TheQRCode.io?

Does TheQRCode.io need an API key?

What transport does TheQRCode.io use?

When was TheQRCode.io last checked?

Documentation

TheQRCode.io MCP Server

Setup

Claude Desktop

Cursor

With an API key (unlocks the analytics tools)

Tools

generate_qr_code — free, no key

list_qr_codes — Developer plan

get_analytics — Developer plan

Plans

Running it yourself

What it wraps

License

`generate_qr_code` — free, no key

`list_qr_codes` — Developer plan

`get_analytics` — Developer plan