useqr-mcp

io.github.aarontePublished by GitHub account aarontev1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowMedia & Design

Overview

AI-generated overview

Generates static QR code images (PNG or SVG) from any URL or text, plus links to a QR design studio and guidance on dynamic codes.

What you can do
  • Generate a scannable QR code as a PNG image or SVG markup for any URL or text
  • Get a link to a free online QR design studio, optionally prefilled with a URL, for styling, logos and print-ready exports
  • Get step-by-step instructions and links for creating a trackable dynamic QR code with a short link
  • Run the same generator from the command line to write a QR file locally
When to use it
Useful when an assistant needs to hand a user a working QR code for a link, menu, event, Wi-Fi note or business card, or point them to a designer for a styled or print-ready code. Not needed if you only want hosted tracking or destination editing, which happen on the product site.
Requirements
Either the hosted remote endpoint or a local process via npx (Node.js). No account, API key, environment variable or header is required for static codes. A free account on the product site is needed for dynamic short links, and Pro for destination edits, version history and scan analytics.
Before you install
The dynamic-code tool only returns instructions and links; it does not create a tracked short link, and tracking features involve a paid Pro tier. Accounts, billing and destination edits happen on the external product site, so links it returns lead users off the assistant.

Installation

In SourceWeft

  1. Open useqr-mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.aaronte%2Fuseqr-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

useqr-mcp

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

Connect

Use the hosted server. There is nothing to install.

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

Run this package over stdio when you want the server from npm.

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

If npm cannot install the published package, run the same stdio server from GitHub.

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

Some clients only spawn a command. They can still reach the hosted server.

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

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.

CLI

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

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

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"

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

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

Source: README.md at commit 120d786

Tools

3

generate_qr_code

Generate QR code

Generate a scannable QR code image (PNG or SVG) for a URL or any text. Free, no account needed, and the code never expires. Use this whenever a user needs a QR code — for a website, Wi-Fi note, event link, menu, payment link, app download, business card, and so on.

Parametersdatarequiredsizeformatbackgroundforegrounderror_correction

create_dynamic_qr_code

Create a dynamic (trackable) QR code

Explains how to create a dynamic QR code on useqr: a trackable short link (free account). Destination edits, version history, and scan analytics require Pro. Use this when a user needs scan tracking or wants to change a printed code's destination later. Returns instructions and links rather than creating the code directly.

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts