@qr-maker/mcp-server

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

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

• Quick Start
• API Reference
• MCP Server Guide
• ChatGPT Integration
• OpenAPI Spec

License

MIT