MCP Server for AI Agents

Last updated:

QR Maker provides an MCP (Model Context Protocol) server with 19 tools. Connect it to Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant to generate QR codes, manage links, and publish landing pages from a conversation.

Quick Setup — Claude Code

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "qr-maker": {
      "command": "npx",
      "args": [
        "tsx",
        "node_modules/@qr-maker/mcp-server/src/index.ts",
        "--api-key=qk_live_YOUR_API_KEY",
        "--api-url=https://api.qr-maker.io"
      ]
    }
  }
}

Then restart Claude Code. Type /mcp to verify the server is connected.

Quick Setup — Cursor / Windsurf

Add to your project's .cursor/mcp.json or equivalent:

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

Environment Variables

Variable	Description
QR_MAKER_API_KEY	Your API key (alternative to --api-key flag)
QR_MAKER_API_URL	API base URL (default: https://api.qr-maker.io)

Available Tools (19)

Tool	Description
generate_qr	Generate a styled QR code with custom colors, dots, logos
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 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
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

Example Prompts

"Generate a QR code for my website with purple dots and rounded corners"
"Create a short link for https://qr-maker.io and show me the analytics"
"Publish a landing page for my restaurant with a menu link and a WhatsApp button"
"List all my style presets and render one with my logo"

Testing with MCP Inspector

npx @modelcontextprotocol/inspector \
  npx @qr-maker/mcp-server -- \
  --api-key=qk_live_YOUR_KEY \
  --api-url=https://api.qr-maker.io

Opens a browser UI where you can call each tool interactively and inspect responses.

Need help?

See the API Reference for endpoint details, or email support@qr-maker.io.