MCP Server

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.