TheQRCode.io

io.theqrcodePublished by theqrcode.ioOfficial publisherv1.5.2Updated Oct 24, 2026

Free styled QR codes, no key: URL, WiFi, contact, text, email. API key adds saved codes + analytics.

VerifiedStreamable HTTPWeb executableData & Analytics Media & Design

Server details

Identifier: io.theqrcode/qr-code-generator
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to theqrcode.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.theqrcode%2Fqr-code-generator.svg)](https://sourceweft.com/mcp/io.theqrcode%2Fqr-code-generator?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Remote MCP server that lets an assistant generate styled QR codes for URLs, WiFi, contacts, text and email, and with a paid key list saved codes and read scan-

What you can do: Generate QR codes for URLs, WiFi networks, contact cards, text and email, with colour, size, dot and corner styling, frames and captions, returned as a hosted image URL and a base64 data URL for inline display. Choose PNG output anonymously, or SVG and PDF output with an API key. List QR codes saved to an authenticated account, with pagination and filtering by type. Read scan analytics account-wide or for one code, covering total and unique scans, time, approximate location, device, OS and campaign.
When to use it: Useful when you want an assistant to produce a QR code on request, for a link, a WiFi network, a contact card or plain text, without installing anything. The account tools are worth adding only if you already hold a Developer plan key and want saved codes or scan analytics inside the chat.
Requirements: A remote streamable HTTP endpoint; no local install. Anonymous use needs no account and is limited to 100 requests per hour per IP. The account tools need a paid Developer plan API key sent as an Authorization Bearer header; Pro keys do not unlock them.

Before you install

The Authorization header carries a paid API key; keep it out of shared configs. Anonymous hosted preview links last only 24 hours, so download the image rather than bookmarking it. Calls count toward the key's REST API limit. Analytics location is derived from IP and is approximate, and static codes cannot be tracked. Paid plans cost money.

Installation

In SourceWeft

Open TheQRCode.io in the dashboard and add it to a workspace.
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/io.theqrcode%2Fqr-code-generator/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": {
    "theqrcode-io": {
      "type": "http",
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

README

TheQRCode.io MCP Server

[Listed on mcpservers.org] [TheQRCode MCP server on Glama]

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.

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

Setup

Claude Desktop

Settings → Developer → Edit Config:

Cursor

~/.cursor/mcp.json:

With an API key (unlocks the analytics tools)

json

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

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

bash

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

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

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

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

Docker:

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.

Source: README.md at commit acc8fa6

Tools

generate_qr_code

Generate a QR code image. Use this whenever a user asks to create, make, or generate a QR code for a URL, website, WiFi network, contact card, email, or text. Returns a hosted image URL and a base64 data URL for inline display. Colour, size, dot and corner styling, frames and captions are free on every plan and with no key at all — offer them freely. When authenticated, the QR code is saved to the user's account and svg/pdf output becomes available.

ParametersnamesizetyperequiredformatcaptioncontentrequireddotStyledarkColorframeStylelightColorcaptionFontcornerStyle

list_qr_codes

List QR codes saved to the authenticated user's account. Supports pagination and filtering by type. Requires an authenticated API key (Developer plan).

Parameterspagetypelimit

get_analytics

Get scan analytics for the authenticated user's QR codes. Optionally filter to a specific QR code by ID. Requires an authenticated API key (Developer plan).

ParametersqrCodeIdtimeRange

Version history

v1.5.2LatestOct 13, 2026
v1.5.1Oct 10, 2026
v1.4.0Sep 27, 2026
v1.3.0Sep 20, 2026
v1.2.0Sep 16, 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

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)

TheQRCode.io

Overview

Installation

In SourceWeft

Use with an agent

Other MCP clients

README

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

Tools

generate_qr_code

list_qr_codes

get_analytics

Version history

Score

`generate_qr_code` — free, no key

`list_qr_codes` — Developer plan

`get_analytics` — Developer plan