Für Agents

QR-Codes, minus Browser.

FreeQrly spricht HTTP und MCP. Statische QR-Codes aus jedem Agent, Skript oder Workflow erzeugen — ohne Key, ohne Anmeldung, ohne Ablauf. Wer eine Anfrage stellen kann, kann einen Code machen.

Verbindungsmöglichkeiten

🧰 MCP-Server

Füge https://freeqrly.com/mcp zu deinem MCP-Client hinzu. Ein Tool — generate_qr — ohne Auth. Funktioniert mit Claude Code, Cursor und allem, was Streamable HTTP spricht.

🌐 HTTP-API

Ein simpler GET-Endpunkt, der SVG liefert. CORS ist weit offen, sodass Browser, curl und Serverless-Funktionen ihn direkt aufrufen können.

📜 Agent-Skill

Eine SKILL.md mit Payload-Rezepten liegt im Repo unter skills/qr-generator/. Zeig deinen Agent darauf und er kennt den Rest.

🤖 llms.txt

/llms.txt beschreibt die ganze Seite für Crawler und Assistenten — Endpunkte, Payload-Formate und Seitenübersicht in einer Datei.

HTTP-API

GET https://freeqrly.com/api/qr?data=TEXT&size=1024&margin=4&color=2F4A62&bgcolor=ffffff&ecc=M

Liefert image/svg+xml. Nur data ist erforderlich; alles andere hat einen sinnvollen Standardwert. Fehler kommen als JSON mit einem error-Feld zurück.

curl "https://freeqrly.com/api/qr?data=https://example.com&size=1024" \
  -o qr.svg

# WiFi QR code for guests
curl "https://freeqrly.com/api/qr?data=WIFI:T:WPA;S:CafeNet;P:s3cret;;" \
  -o wifi.svg

Parameter

  • data — zu kodierender Text (erforderlich, max. 2000 Zeichen). URLs, WLAN-Strings, vCards, Klartext.
  • size — Ausgabegröße in px, 128–2048 (Standard 1024).
  • margin — Ruhezone in Modulen, 0–10 (Standard 4).
  • color / bgcolor — 6-stelliges Hex, kein # (Standards 2F4A62 / ffffff).
  • ecc — Fehlerkorrektur L, M, Q, H (Standard M). Für Druck oder Logos Q/H nutzen.

MCP

POST https://freeqrly.com/mcp

Standard-Streamable-HTTP: initialize, dann tools/list / tools/call. Das generate_qr-Tool nimmt data, size, color, bgcolor, ecc und liefert eine direkt herunterladbare SVG-URL.

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "generate_qr",
    "arguments": { "data": "https://example.com", "size": 1024 }
  }
}

Payload-Rezepte

Website : https://example.com/menu
WiFi    : WIFI:T:WPA;S:CafeNet;P:s3cret;;
Contact : BEGIN:VCARD\nVERSION:3.0\nN:Ada Lovelace\nTEL:+15550100\nEND:VCARD
Place   : geo:37.7749,-122.4194
SMS     : sms:+15550100?body=Hello

Faire Nutzung

Es ist kostenlos, aber sei nett: Cache Ergebnisse, statt denselben Code neu anzufordern, und halt automatisierten Traffic in vernünftigem Rahmen. Pro-IP-Ratenbegrenzungen gelten. Statische Codes sind deterministisch — derselbe Input ergibt immer denselben Output, also ist Caching trivial.