# qr-maker-io/mcp-server [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/qr-maker-io/mcp-server  
**GitHub Stars:** 1  
**npm Downloads (last month):** 1082816  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/qr-maker-io-mcp-server

## Description
Generate styled QR codes, manage dynamic short links with click analytics, and publish micro-landing pages. Install: npx @qr-maker/mcp-server --api-key=YOURKEY.

## Tools
Capabilities this server exposes over MCP:

- **generate_qr** — Generate a styled QR code with custom colors, dots, logos, and frames
- **batch_generate** — Batch generate up to 100 QR codes (Pro+)
- **get_batch_status** — Poll batch job status
- **create_short_link** — Create a tracked short link with click analytics
- **list_links** — List short links with click counts
- **get_link** — Get details of a specific short link
- **update_link** — Update target URL, status, or expiration
- **delete_link** — Permanently delete a short link
- **get_link_analytics** — Click analytics — countries, devices, daily breakdown
- **create_template** — Save a reusable QR style preset
- **list_templates** — List saved style presets
- **update_template** — Update a style preset
- **delete_template** — Delete a style preset
- **render_template** — Generate QR using a saved style preset
- **publish_landing** — Publish HTML landing page + short link + QR in one call
- **get_landing** — Get landing page details
- **update_landing** — Update landing HTML and re-publish
- **get_usage** — Check current quota and usage
- **get_capabilities** — Feature matrix for your plan

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-server": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"],
    "env": {
      "QR_MAKER_API_KEY": "",
      "QR_MAKER_API_URL": ""
    }
  }
}
```

**Requires environment variables:** `QR_MAKER_API_KEY`, `QR_MAKER_API_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What qr-maker-io/mcp-server MCP server does

qr-maker-io/mcp-server MCP server exposes QR Maker capabilities as MCP tools for connected AI assistants. It supports styled QR generation with configurable colors, dot patterns, logos, and frames. Agents can also create and manage dynamic short links, inspect click counts, and retrieve analytics by country, device, and day.

The server covers four main workflows:

- Generate individual QR codes or submit batches of up to 100 codes on Pro and higher plans.
- Create, inspect, update, and delete tracked short links.
- Save QR styling as reusable templates and render new codes from those presets.
- Publish HTML landing pages together with a short link and QR code, then retrieve or update them.

Account tools report current usage and expose the feature matrix for the active plan.

## How it works

The package runs as a local MCP process using `npx`. An MCP client starts the process and passes requests to QR Maker’s API. Authentication uses a QR Maker API key. The key can be passed with `--api-key` or provided through `QR_MAKER_API_KEY`.

The default API base URL is `https://api.qr-maker.io`; an alternative can be supplied with `QR_MAKER_API_URL`. After connecting the server to an assistant, prompts can invoke the exposed tools to create QR assets, manage links, or publish landing pages. Batch generation is asynchronous: an agent submits the batch and uses `get_batch_status` to check its progress.

## Setup and configuration

qr-maker-io/mcp-server MCP server is distributed as the `@qr-maker/mcp-server` npm package. Obtain an API key by creating an account at qr-maker.io, opening Settings, selecting API Keys, and creating a key.

A client configuration can launch the server with `npx` and the package name, followed by the API key option. Alternatively, configure `QR_MAKER_API_KEY` in the process environment. `QR_MAKER_API_URL` is optional because the documented default points to the QR Maker API.

The README provides configuration examples for Claude Code, Cursor, and Windsurf. It also documents checking the connection from Claude Code with `/mcp`.

## Tools and capabilities

The 19 listed tools are grouped as follows:

- QR generation: `generate_qr`, `batch_generate`, and `get_batch_status`.
- Short links: `create_short_link`, `list_links`, `get_link`, `update_link`, `delete_link`, and `get_link_analytics`.
- Templates: `create_template`, `list_templates`, `update_template`, `delete_template`, and `render_template`.
- Landing pages: `publish_landing`, `get_landing`, and `update_landing`.
- Account information: `get_usage` and `get_capabilities`.

`publish_landing` combines HTML publication, short-link creation, and QR generation in one operation. Template tools are useful when multiple QR codes need a consistent saved style.

## Limitations and notes

qr-maker-io/mcp-server MCP server requires a QR Maker API key and access to the QR Maker service. The available features depend on the account plan; batch generation is specifically marked as available on Pro and higher plans. The material does not specify the pricing structure, rate limits, supported QR content types, or the exact response format for generated images.

Deleting a short link is described as permanent. Landing-page updates re-publish the HTML. The repository is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/qr-maker-io-mcp-server/readme_

