home / mcp / qr tool mcp server

QR Tool MCP Server

Provides programmatic access to styled QR code generation via MCP over HTTP and stdio.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kalypsokichu-code-qr-tool-mcp": {
      "url": "https://qr-tool-mcp.vercel.app/api/mcp"
    }
  }
}

You can generate styled QR codes programmatically using an MCP server that exposes both an HTTP endpoint and a local, stdio-based workflow. This server supports 10 preset styles, SVG/PNG exports, logo options, and seamless integration with AI tools, enabling you to generate QR codes from any URL or text—whether you’re automating a workflow or adding QR generation to an AI-assisted pipeline.

How to use

Connect to the HTTP MCP endpoint or run the local stdio server to generate QR codes from your automation tool. You can generate a single QR code by specifying the URL or text you want to encode and choose a style preset (for example, slate-ember or neon-pulse). You can also batch-create multiple QR codes and receive a ZIP file containing SVGs. When using the HTTP option, point your MCP client at the URL and pass the required parameters; for local usage, run the stdio command and provide the parameters through your tool’s MCP interface.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Web App setup steps you will run locally:

# Install dependencies for the web app
npm install

# Run the development server
npm run dev

# Open http://localhost:3000 to view the QR code generator

Build and start the web app for production:

# Build the Next.js app for production
npm run build:next

# Start the production server
npm start

MCP Server quick-start and local development steps:

# Build the MCP server (local development)
npm run build:mcp

# Start the MCP server in stdio mode (local development)
npm run start:mcp

Additional notes and examples

MCP supports two primary methods to access QR code generation: an HTTP endpoint for remote calls and a local stdio workflow for direct integration with AI tools. You can extract a single QR code or generate multiple codes in a batch, with style presets applied consistently across all outputs. The available styles include slate-ember, ink-lime, charcoal-cyan, night-sky, graphite-gold, espresso-rose, plum-ice, forest-mint, cocoa-orange, and mono-high.

Example use cases include generating a single QR code for a URL such as https://instagram.com/kalypsodesigns using a neon-pulse style, or producing a ZIP archive of SVGs for a list of pages via a batch call.

Notes on configuration and usage

Available MCP connections include an HTTP endpoint and a local stdio server. The HTTP endpoint URL is provided for remote access, while the stdio workflow uses a local command invocation. If you plan to run locally, use the provided commands and ensure they run in your environment with your package manager. Style presets are applied by default when not explicitly overridden.

Available tools

generate_qr_code

Create a single styled QR code by providing a URL or text, with optional style, format, size, and logo position.

generate_qr_urls_batch

Generate multiple QR codes in one go and receive a ZIP file containing all codes as SVGs, with a chosen style.

get_available_styles

List all available style presets and their color schemes for QR code generation.

preview_qr_url

Create a shareable web preview URL to customize and visualize a QR code before final generation.