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.