Skip to main content
Glama
Sign In
deenesjakoruzh
qr-maker

qr-maker

by qr-maker-io
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@qr-maker/mcp-server

Glama score npm

MCP (Model Context Protocol) server for QR Maker — generate styled QR codes, manage dynamic short links with click analytics, and publish micro-landing pages from any AI assistant.

Quick Start

Claude Code

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "qr-maker": {
      "command": "npx",
      "args": [
        "@qr-maker/mcp-server",
        "--api-key=qk_live_YOUR_API_KEY"
      ]
    }
  }
}

Restart Claude Code and type /mcp to verify.

Cursor / Windsurf

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "qr-maker": {
      "command": "npx",
      "args": ["@qr-maker/mcp-server", "--api-key=qk_live_YOUR_API_KEY"]
    }
  }
}

Environment Variables

Instead of --api-key, you can set:

export QR_MAKER_API_KEY=qk_live_YOUR_API_KEY
export QR_MAKER_API_URL=https://api.qr-maker.io  # default

Related MCP server: QrVerloz MCP Server

Get Your API Key

  1. Sign up at qr-maker.io

  2. Go to Settings → API Keys

  3. Click Create Key and copy it

Available Tools (19)

QR Code Generation

Tool

Description

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

Short Links

Tool

Description

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

Style Presets

Tool

Description

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

Landing Pages

Tool

Description

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

Account

Tool

Description

get_usage

Check current quota and usage

get_capabilities

Feature matrix for your plan

Example Prompts

Once connected, try:

  • "Generate a QR code for my website with purple rounded dots"

  • "Create a short link for https://qr-maker.io and show me the analytics"

  • "Publish a landing page for my restaurant with a menu and WhatsApp button"

  • "List my style presets and render one with new content"

Testing with MCP Inspector

npx @modelcontextprotocol/inspector \
  npx @qr-maker/mcp-server -- \
  --api-key=qk_live_YOUR_KEY

Documentation

License

MIT

Available Tools

19 tools
batch_generateA

Generate multiple QR codes in bulk (up to 100). Requires Pro tier or above. Returns a batch ID to poll for status. Each item can have different content and style.

Inputs: items (required), webhook_url.

create_short_linkA

Create a tracked short link with click analytics. Use this to add tracking to QR codes — encode the short URL as the QR content. Supports custom codes and expiration dates.

Inputs: target_url (required), custom_code, expires_at.

create_templateA

Save a QR code style preset. Style presets store visual settings (colors, dot styles, logos, dimensions) that can be applied to any content via render_template. Styles are unlimited and do not count against your quota.

Inputs: name (required), options (required), description, tags, +1 more.

delete_linkA

Permanently delete a short link and all its associated data (QR targets, analytics, landing pages). This action cannot be undone. Consider using update_link with status "disabled" instead.

Inputs: link_id (required).

delete_templateA

Permanently delete a QR code style preset. This action cannot be undone. Short links using this style will keep their current QR appearance.

Inputs: template_id (required).

generate_qrA

Generate a styled QR code image with custom colors, logos, dot styles, and corner shapes. Supports PNG and SVG output. Returns base64-encoded image data. When the content is a URL, a tracked short link is created automatically — the QR encodes the short URL for click analytics.

Inputs: content (required), format, template_id, style.

get_batch_statusA

Check the status of a batch QR generation job. Use after batch_generate to poll for completion. Returns total, completed, failed counts and individual item statuses.

Inputs: batch_id (required).

get_capabilitiesA

Get the full feature matrix for your current API key tier. Shows available features, rate limits, quota, analytics retention, SLA, and upgrade options. Call this first to understand what operations are available.

Inputs: no named parameters.

get_landingA

Retrieve full details of a published micro-landing page by its ID. Returns the page title, public URL (via its associated short link), HTML content, publish status, version history, and the short link code used for QR code generation. Use this to verify a landing page was published correctly, retrieve its public URL to share or encode in a QR, or inspect its current content before calling update_landing. The landing_id is returned by publish_landing when the page is created.

Inputs: landing_id (required).

get_linkB

Get details of a specific short link by ID or code — target URL, status, click count, QR style, and creation date.

Inputs: link_id (required).

get_link_analyticsB

Get click analytics for a short link — total clicks, unique visitors, breakdown by country and day. Covers the last 30 days.

Inputs: link_id (required).

get_usageA

Check current billing period usage, quota limits, and estimated cost. Shows QR codes generated, links created, and API calls for the current month.

Inputs: no named parameters.

list_linksA

List tracked short links with click counts. Supports cursor pagination. Returns code, target URL, status, and creation date for each link.

Inputs: cursor, limit.

list_templatesA

List saved QR code style presets. Styles store visual settings (colors, dots, logos) that can be reused across QR codes. Supports cursor pagination.

Inputs: cursor, limit.

publish_landingA

Publish an HTML landing page and get back a hosted URL, tracked short link, and QR code image in one call. The landing is published to CDN and a short link is created for QR tracking. Free-tier landings include a watermark footer.

Inputs: html (required), title, format, style.

render_templateA

Generate a QR code by applying a saved style preset to new content. Looks up the template by ID, merges any provided overrides on top of the stored style options, then renders the QR code. Returns a public image URL and, for PNG output, an inline base64 image. Use this instead of generate_qr when the user has a saved brand style they want to reuse — avoids re-specifying all style options each time. Use overrides to tweak individual properties (e.g. foreground color) without changing the saved preset.

Inputs: template_id (required), content (required), format, overrides.

update_landingA

Update a landing page HTML content and re-publish to CDN. The existing short link and QR code continue to work — only the page content changes.

Inputs: landing_id (required), html (required), title.

update_linkA

Update a short link — change target URL, status, or expiration. Set status to "disabled" to deactivate without deleting. The QR code continues to work but redirects will stop.

Inputs: link_id (required), target_url, status, expires_at, +1 more.

update_templateA

Update an existing QR code style preset. Accepts partial updates — only the fields you provide are changed; omitted fields keep their current values. The options field, if provided, fully replaces the stored style options. Use this to rename a preset, adjust colors or shapes, change visibility (is_public), or update tags for searchability. Returns the updated template object including its ID, name, options, and timestamps. Call list_templates first if you need to find the template_id.

Inputs: template_id (required), name, description, options, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 19 tools

    Disambiguation4/5

    Most tools map cleanly to distinct resources and actions (templates, links, landing pages, batch jobs). Some overlap exists between generate_qr, render_template, and create_short_link, especially since generate_qr auto-creates short links, but the descriptions provide enough distinction to guide selection.

    Naming Consistency4/5

    The set generally follows a verb_noun pattern (create_template, list_links, get_landing), but a few tools deviate: batch_generate is not object-noun, render_template uses render instead of generate/create, and get_usage/get_capabilities sit outside the resource-based naming.

    Tool Count4/5

    19 tools is on the heavier side, but they cover several related subdomains: QR generation, short-link management, templates, landing pages, and billing. Each tool has a distinct role, so the count is slightly over ideal but not excessive.

    Completeness4/5

    Templates, short links, batch jobs, and usage insights have solid coverage. Landing pages lack a delete operation and there's no listing endpoint for published landings, but the core QR generation and link-tracking workflows are complete.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • QR for Agent

      benswel
      A
      license
      A
      quality
      F
      maintenance
      Dynamic QR code platform for AI agents. Create, customize, and track QR codes without regenerating images. 37 tools covering 11 QR types (URL, vCard, WiFi, event…).
      37
      3
      MIT

    • QrVerloz MCP Server

      neaj-Corp
      A
      license
      Not graded
      quality
      D
      maintenance
      QrVerloz lets AI agents create QR codes instantly — no account needed, active for 90 days, and claimable at any time to make them permanent. Retarget the destination URL whenever you need, without reprinting.
      3
      MIT

    • QRSalt MCP server

      QRSalt
      A
      license
      Not graded
      quality
      C
      maintenance
      Lets an AI assistant create QR codes and short links, re-point or pause them, inspect scan counts and analytics, and read the contents of a QR image you supply. It connects to a hosted workspace over Streamable HTTP, so codes can be managed and tracked without leaving the chat.
      MIT
    • esyURL MCP server

      esyURL MCP serverofficial

      esyurl
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to create, update, organize, and delete short links; render styled QR codes; route visitors by device or country; and read click and scan statistics. Agents can also manage groups and custom domains while changing destinations without breaking printed QR codes or shared short URLs.
      MIT