useqr-mcp

Static QR PNG/SVG for agents. Designer and dynamic codes live at useqr.co.

OtherTypeScriptv1.0.0

useqr-mcp

Generate a static QR code from any AI agent. No account. No API key.

npx -y useqr-mcp generate --data https://example.com --out qr.png

This repository is the agent-facing QR generator for useqr.co. It writes PNG or SVG locally. Styled dots, logos, and dynamic /r/{code} short links stay on the product site.

Install and discovery

  • npm: useqr-mcp
  • Official MCP registry name: io.github.aaronte/useqr-mcp
  • Hosted remote: https://useqr.co/api/mcp
  • Search: curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=useqr"
npx -y useqr-mcp

No arguments (or mcp) starts the stdio MCP server. Source install still works: npx -y github:aaronte/useqr-mcp.

MCP

Stdio (works in Cursor, Claude, Copilot, and other clients that spawn a command):

{
  "mcpServers": {
    "useqr": {
      "command": "npx",
      "args": ["-y", "useqr-mcp"]
    }
  }
}

Hosted Streamable HTTP (same tools, nothing to install):

{
  "mcpServers": {
    "useqr": {
      "url": "https://useqr.co/api/mcp"
    }
  }
}

stdio-only clients can wrap the hosted server with mcp-remote:

{
  "mcpServers": {
    "useqr": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://useqr.co/api/mcp"]
    }
  }
}

Tools

ToolWhat it returns
generate_qr_codePNG image or SVG markup for any URL or text
get_qr_designer_linkLink to the free designer at useqr.co, optionally prefilled
create_dynamic_qr_codeInstructions only. Does not mint a tracked short link

CLI

npx -y useqr-mcp generate --data https://example.com --format svg --out qr.svg
npx -y useqr-mcp help

npx -y useqr-mcp with no arguments starts the MCP stdio server.

What this is not

This is not the UseQR product app. Accounts, billing, public pages, and destination edits live at useqr.co. See useqr.co/mcp for the hosted server card and product brief.

The live product card uses namespace co.useqr/mcp. This OSS listing uses the GitHub namespace io.github.aaronte/useqr-mcp and points at the same hosted remote.

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y useqr-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-aaronte-useqr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "useqr-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

useqr-mcpnpm

Compatible MCP Clients

useqr-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More