useqr-mcp
Static QR PNG/SVG for agents. Designer and dynamic codes live at useqr.co.
Open source Repository Open in the app JSON README (API)
About
Static QR PNG/SVG for agents. Designer and dynamic codes live at useqr.co.
Details
- Kind
- MCP servers
- Topic
- Media, design & games
- Publisher
- aaronte
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-09-04T17:22:06Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-09-04 15:00:38
- Updated
- 2026-09-04 15:00:38
- Origin id
io.github.aaronte/useqr-mcp
README
# useqr-mcp
Generate a static QR code from any AI agent. No account. No API key.
```bash
npx -y useqr-mcp generate --data https://example.com --out qr.png
```
This repository is the agent-facing QR generator for [useqr.co](https://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`](https://www.npmjs.com/package/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"`
```bash
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):
```json
{
"mcpServers": {
"useqr": {
"command": "npx",
"args": ["-y", "useqr-mcp"]
}
}
}
```
Hosted Streamable HTTP (same tools, nothing to install):
```json
{
"mcpServers": {
"useqr": {
"url": "https://useqr.co/api/mcp"
}
}
}
```
stdio-only clients can wrap the hosted server with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):
```json
{
"mcpServers": {
"useqr": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://useqr.co/api/mcp"]
}
}
}
```
## 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 |
## CLI
```bash
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](https://useqr.co). See [useqr.co/mcp](https://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