About useqr-mcp
useqr-mcp is an MCP server and CLI for agents that generates static QR codes as PNG or SVG from a URL or text. It can also link to useqr.co’s designer; dynamic tracked links are not created by the server.
Key features
- 01Generate QR codes from URLs or text
- 02Output PNG or SVG
- 03Provide a prefilled designer link
- 04CLI and hosted server options
Use cases
- 01Create a QR image for a website URL
- 02Export a QR code as SVG
- 03Open the designer with content prefilled
MCP support
The server exposes QR generation, designer-link, and dynamic-code instruction tools to MCP clients. It is available as a hosted remote server or can run over stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://useqr.co/api/mcpclaude mcp add --transport http aaronte-useqr https://useqr.co/api/mcp{"mcpServers":{"aaronte-useqr":{"type":"http","url":"https://useqr.co/api/mcp"}}}Open in Cursor{"servers":{"aaronte-useqr":{"type":"http","url":"https://useqr.co/api/mcp"}}}Open in VS Code{"mcpServers":{"aaronte-useqr":{"type":"http","url":"https://useqr.co/api/mcp"}}}{"mcpServers":{"aaronte-useqr":{"serverUrl":"https://useqr.co/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| data | string | Yes | The URL or text to encode in the QR code. |
| size | integer | No | Width and height in pixels (PNG only). |
| format | enum | No | Output format. png returns an image; svg returns vector markup that scales to any print size.png | svg |
| background | string | No | Background color as a hex string. |
| foreground | string | No | Foreground (dark module) color as a hex string. |
| error_correction | enum | No | Error correction level. Higher levels stay scannable when the code is partially damaged or overlaid with a logo, at the cost of density.L | M | Q | H |
Details
From the project READMEuseqr-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.
{
"mcpServers": {
"useqr": {
"url": "https://useqr.co/api/mcp"
}
}
}
Run this package over stdio when you want the server from npm.
{
"mcpServers": {
"useqr": {
"command": "npx",
"args": ["-y", "useqr-mcp"]
}
}
}
If npm cannot install the published package, run the same stdio server from GitHub.
{
"mcpServers": {
"useqr": {
"command": "npx",
"args": ["-y", "github:aaronte/useqr-mcp"]
}
}
}
Some clients only spawn a command. They can still reach the hosted server.
{
"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
npx -y useqr-mcp generate --data https://example.com --out qr.png
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. 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
| Tool | What it returns |
|---|---|
generate_qr_code | PNG image or SVG markup for any URL or text |
get_qr_designer_link | Link to the free designer at useqr.co, optionally prefilled |
create_dynamic_qr_code | Instructions 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.