# Qr Code Mcp

> QR code generation via MCP. Generate, style with logos, decode. Free + $19/mo.

- **Type:** MCP server
- **Install:** `agentstack add mcp-rumblingb-qr-code-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Rumblingb](https://agentstack.voostack.com/s/rumblingb)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Rumblingb](https://github.com/Rumblingb)
- **Source:** https://github.com/Rumblingb/qr-code-mcp
- **Website:** https://rumblingb.github.io/qr-code-mcp/

## Install

```sh
agentstack add mcp-rumblingb-qr-code-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# QR Code MCP Server

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that lets you **generate, decorate, and decode QR codes** directly from any MCP client (Claude Desktop, Cursor, VS Code via Continue.dev, etc.).

---

## Features

| Tool                    | Description                                      |
| ----------------------- | ------------------------------------------------ |
| `generate_qr`           | Generate a QR code PNG from text or a URL        |
| `generate_qr_with_logo` | Generate a QR code with a centered logo image    |
| `decode_qr`             | Decode a QR code from a base64-encoded PNG       |

---

## Quick Start

### Prerequisites

- Python 3.10+
- pip

### Installation

```bash
# Create the project directory
mkdir qr-code-mcp && cd qr-code-mcp

# Install dependencies
pip install -r requirements.txt

# (Optional) Install pyzbar for QR decoding
pip install pyzbar
```

> **Note for Windows users**: `pyzbar` requires the [ZBar library](https://zbar.sourceforge.net/). Download the Windows build and ensure `zbar.dll` is on your `PATH`, or use the [Windows PyPI wheel](https://pypi.org/project/pyzbar/).

### Run the server

```bash
python server.py
```

The server starts in **stdio mode**, ready to connect to any MCP client.

---

## MCP Client Configuration

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "qr-code-mcp": {
      "command": "python",
      "args": ["/absolute/path/to/qr-code-mcp/server.py"]
    }
  }
}
```

### VS Code (Continue.dev)

Add to your `~/.continue/config.json`:

```json
{
  "experimental": {
    "mcpServers": [
      {
        "name": "qr-code-mcp",
        "transport": "stdio",
        "command": "python",
        "args": ["/absolute/path/to/qr-code-mcp/server.py"]
      }
    ]
  }
}
```

---

## Usage Examples

### 1. Generate a QR code

```python
# Input
data = "https://example.com"
size = 400

# Returns:
# {
#   "format": "png",
#   "base64": "iVBORw0KGgo...",
#   "mime_type": "image/png"
# }
```

### 2. Generate a QR code with a logo

```python
# Input
data = "https://example.com"
logo_url = "https://example.com/logo.png"
size = 400

# Returns the same format as `generate_qr` with the logo centered
# on the QR code. If the logo download fails, the QR code is
# returned without the logo and an error note is provided.
```

### 3. Decode a QR code

```python
# Input
image_base64 = "iVBORw0KGgo..."

# Returns:
# {
#   "data": "https://example.com"
# }
```

Requires `pyzbar`. If not installed, a helpful error message with install instructions is returned instead.

---

## API Reference

### `generate_qr(data, size?, format?)`

| Parameter | Type    | Default | Description                           |
| --------- | ------- | ------- | ------------------------------------- |
| `data`    | string  | --      | Text or URL to encode (required)      |
| `size`    | integer | `400`   | Width/height of the output PNG        |
| `format`  | string  | `"png"` | Output format (currently only `"png"`) |

### `generate_qr_with_logo(data, logo_url?, size?)`

| Parameter  | Type    | Default | Description                                |
| ---------- | ------- | ------- | ------------------------------------------ |
| `data`     | string  | --      | Text or URL to encode (required)           |
| `logo_url` | string  | `""`    | URL of the logo image to center on the QR  |
| `size`     | integer | `400`   | Width/height of the output PNG             |

### `decode_qr(image_base64)`

| Parameter      | Type   | Default | Description                           |
| -------------- | ------ | ------- | ------------------------------------- |
| `image_base64` | string | --      | Base64-encoded PNG data (required)    |

---

## Smithery Deployment

This server is ready to deploy on [Smithery.ai](https://smithery.ai). The `smithery.yaml` configuration is included in this repository.

---

## Pricing

**$19/month** — includes:
- Priority support
- No rate limits
- Commercial license

[Subscribe now](https://buy.stripe.com/dRm6oJ4Hd2Jugek0wz1oI0m)

---

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Rumblingb](https://github.com/Rumblingb)
- **Source:** [Rumblingb/qr-code-mcp](https://github.com/Rumblingb/qr-code-mcp)
- **License:** MIT
- **Homepage:** https://rumblingb.github.io/qr-code-mcp/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-rumblingb-qr-code-mcp
- Seller: https://agentstack.voostack.com/s/rumblingb
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.