{
  "markdown": "# TheQRCode.io MCP Server\n\n[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/theqrcode-io-mcp)\n\nGenerate QR codes — and read their scan analytics — from Claude, Cursor, or any MCP client.\n\n**Remote HTTP server. Nothing to install.** No npm, no Docker, no Python. Point your client at one\nURL and ask.\n\n```\nhttps://mcp.theqrcode.io/mcp\n```\n\nListed in the official MCP Registry as **`io.theqrcode/qr-code-generator`**.\n\n---\n\n## Setup\n\n### Claude Desktop\n\nSettings → Developer → Edit Config:\n\n```json\n{\n  \"mcpServers\": {\n    \"theqrcode\": {\n      \"url\": \"https://mcp.theqrcode.io/mcp\"\n    }\n  }\n}\n```\n\n### Cursor\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"theqrcode\": {\n      \"url\": \"https://mcp.theqrcode.io/mcp\"\n    }\n  }\n}\n```\n\n### With an API key (unlocks the analytics tools)\n\n```json\n{\n  \"mcpServers\": {\n    \"theqrcode\": {\n      \"url\": \"https://mcp.theqrcode.io/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nAny client supporting the MCP spec over streamable HTTP works. Restart the client after editing\nconfig, then just ask: *\"Generate a QR code for https://example.com\"*.\n\n---\n\n## Tools\n\nThree tools. All three are advertised to every session — including anonymous ones, so directory\ncrawlers see the real surface — but the two account tools refuse at call time without a key.\n\n### `generate_qr_code` — free, no key\n\n| Param | Type | Required | Notes |\n|---|---|---|---|\n| `type` | `url` \\| `wifi` \\| `contact` \\| `text` \\| `email` | yes | `email` requires a key |\n| `content` | string | yes | the data to encode |\n| `name` | string | no | display name when saving to an account |\n| `size` | int 64–1024 | no | default 256 |\n| `darkColor` | `#RRGGBB` | no | default `#000000` |\n| `lightColor` | `#RRGGBB` | no | default `#FFFFFF` |\n\nReturns a hosted PNG URL plus a base64 data URL for inline display.\n\n**Anonymous** → the public keyless API, 100 requests/hour per IP. The hosted link is a **24-hour\npreview**; download the image rather than bookmarking the URL. The QR code itself never expires —\nit is the preview *hosting* that is temporary.\n\n**Authenticated** → the v1 API. The code is **saved to your account permanently**, rate limited by\nkey rather than IP, and `email` becomes available.\n\n### `list_qr_codes` — Developer plan\n\nLists codes saved to your account. `page`, `limit` (1–100), `type` filter.\n\n### `get_analytics` — Developer plan\n\nScan analytics, account-wide or for one `qrCodeId`. `timeRange`: `1h`, `1d`, `7d`, `30d`\n(default), `90d`, `1y`.\n\nReturns total and unique scans, time, approximate location (country/city derived from IP — regional,\nnot GPS), device and OS, and campaign. Static QR codes cannot be tracked; analytics require a dynamic\ncode.\n\n---\n\n## Plans\n\n| | Anonymous | Developer ($19/mo) | Pro ($29/mo) |\n|---|---|---|---|\n| `generate_qr_code` | ✅ url, wifi, contact, text | ✅ + email | ✅ + email |\n| Codes saved to account | ❌ 24h preview link | ✅ permanent | ✅ permanent |\n| `list_qr_codes` | ❌ | ✅ | ❌ |\n| `get_analytics` | ❌ | ✅ | ❌ |\n| Rate limit | 100/hr per IP | 5,000/hr per key | 5,000/hr per key |\n\nAPI keys: <https://theqrcode.io/pricing>\n\n---\n\n## Running it yourself\n\nThe hosted server at `mcp.theqrcode.io` is the supported path — you do not need to run this. But it\nis a plain Express app if you want to:\n\n```bash\nnpm install\nnpm run build\nnpm start          # or: npm run dev\nnpm test\n```\n\n| Env | Default | Purpose |\n|---|---|---|\n| `QR_API_BASE` | `https://theqrcode.io` | REST API this server wraps |\n| `PORT` | `3001` | listen port |\n\nRoutes: `POST|GET|DELETE /mcp` (stateless — a fresh server and transport per request), `GET /health`.\n\nDocker:\n\n```bash\ndocker build -t theqrcode-mcp .\ndocker run -p 3001:3000 -e PORT=3000 theqrcode-mcp\n```\n\n---\n\n## What it wraps\n\nTheQRCode.io is a QR code generation and analytics platform: static and dynamic QR codes for URLs,\nWiFi, vCard contacts and text, with scan analytics by time, device and approximate location. Static\ncodes never expire, and printed codes are never switched off to force an upgrade.\n\nThis server is one of three ways in — the others are a\n[keyless REST API](https://theqrcode.io/qr-code-api) and\n[OpenAI function calling](https://theqrcode.io/ai-agents).\n\n- Site — <https://theqrcode.io>\n- REST API — <https://theqrcode.io/qr-code-api>\n- OpenAPI spec — <https://theqrcode.io/api/public/qr-codes/openapi.json>\n- Agent guide — <https://theqrcode.io/llms-full.txt>\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 4537,
  "sha": "f60479875dd742eac588eaa80e18d3f740199ddd9bbc04daf03ced0da67252ae",
  "repo_slug": "awilliams-2020/theqrcode-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_theqrcode_qr_code_generator_5578a0e8/readme"
}