tools/list und ruft danach jedes Tool mit tools/call auf. Der Server beherrscht sowohl die aktuelle MCP-Revision (2026-07-28, bei der ein Client mit server/discover beginnt) als auch ältere Revisionen (bei denen er mit initialize beginnt) und meldet sich als scanova-mcp. Alle 82 Tools arbeiten auf Ihrem eigenen Scanova-Konto, mit den Anmeldedaten, mit denen sich Ihr Client authentifiziert hat — siehe Setup.
Der Typ jedes Tools entspricht seiner MCP-Annotation: Nur lesend liest ausschließlich, Schreibend fügt etwas hinzu oder ändert es, ohne etwas wegzunehmen, und Destruktiv kann etwas löschen, überschreiben oder abschalten, das gerade live ist — dazu zählt auch, zu ändern, was ein gedruckter QR-Code anzeigt. Die Gruppierung unten stammt von uns und soll die Liste übersichtlicher machen — der Server selbst gibt eine einzige flache Liste zurück.
Scanova-Dokumentations-Brücke
Erlaubt dem Assistenten, diese Dokumentationsseite mitten im Gespräch live nachzuschlagen.| Tool | Typ | Beschreibung |
|---|---|---|
probe_docs_mcp | Nur lesend | Prüft die Konnektivität zu Scanovas Dokumentations-MCP-Server und listet dessen verfügbare Tools auf |
query_docs | Nur lesend | Durchsucht diese Dokumentation (mode="search") oder führt einen schreibgeschützten, dateisystemartigen Befehl aus – cat, head, rg, tree, jq – um eine bestimmte Referenzseite direkt zu lesen (mode="filesystem") |
Kategorien und Prüfung
Referenzdaten, die der Assistent heranziehen kann, bevor er etwas anlegt.| Tool | Typ | Beschreibung |
|---|---|---|
get_qr_categories | Nur lesend | Listet verfügbare QR-Code-Kategorien auf (URL, vCard, WiFi, Document, Social Media usw.) |
get_qr_category_fields | Nur lesend | Gibt die erforderlichen und optionalen info-JSON-Felder einer Kategorie zurück, oder die aller Kategorien auf einmal. Statische Referenzdaten, daher ohne API-Aufruf |
validate_qr_info | Nur lesend | Prüft Kategorie und info-Nutzdaten, bevor create_qr_code oder update_qr_code läuft, und erkennt fehlerhaftes JSON, fehlende Pflichtfelder und ungültige Werte |
QR-Code-Design
Design-Vorschauen werden nie gespeichert: Der Assistent zeigt zuerst Optionen und wendet dann die von Ihnen gewählte mitset_qr_design an.
| Tool | Typ | Beschreibung |
|---|---|---|
get_qr_design_options | Nur lesend | Gibt den vollständigen Katalog der Design-Optionen zurück – Datenmuster, Farbverlaufsstile, Augenformen, Rahmen, Fehlerkorrekturstufen und Schriftarten –, sodass der Assistent echte Auswahlmöglichkeiten anbieten kann, bevor er set_qr_design aufruft |
preview_qr_design | Nur lesend | Zeigt eine Vorschau eines Designs, ohne es zu speichern: das zusammengeführte Design, Prüfungen der Scansicherheit (Farbkontrast von Punkten und Augen, Fehlerkorrektur bei einem Logo, invertierte oder transparente Hintergründe), einen echten Scantest an einem gerenderten Bild sowie das Bild selbst. Funktioniert für einen bestehenden QR-Code oder für neue Inhalte |
set_qr_design | Destruktiv | Wendet ein visuelles Design auf einen bestehenden QR-Code an, ausgehend von benutzerfreundlich benannten Parametern. Nur die von Ihnen angegebenen Felder ändern sich; alles andere wird mit dem aktuellen Design des QR-Codes zusammengeführt. Lehnt ein Design ab, das die Prüfungen der Scansicherheit nicht besteht, sofern Sie das Risiko nicht ausdrücklich in Kauf nehmen (accept_risk) |
QR-Code-Verwaltung
| Tool | Typ | Beschreibung |
|---|---|---|
create_qr_code | Schreibend | Erstellt einen neuen QR-Code, sobald Name, Kategorie, Typ und info-Nutzdaten bekannt sind |
open_qr_code_creation_form | Nur lesend | Öffnet stattdessen ein interaktives Formular – für den Fall, dass Sie einen QR-Code angefragt haben, ohne alles Nötige mitzuliefern |
list_qr_codes | Nur lesend | Listet QR-Codes und Pages im Konto auf, mit Paginierung und Suche, oder beschränkt die Liste auf eines von beiden |
retrieve_qr_code | Nur lesend | Ruft die Details eines bestimmten QR-Codes ab |
update_qr_code | Destruktiv | Aktualisiert einen bestehenden QR-Code |
activate_qr_code | Schreibend | Aktiviert einen QR-Code |
deactivate_qr_code | Destruktiv | Deaktiviert einen QR-Code |
delete_qr_code | Destruktiv | Löscht einen QR-Code dauerhaft |
download_qr_code | Nur lesend | Lädt ein QR-Code-Bild als PNG, JPG oder PDF herunter |
list_tags | Nur lesend | Listet die Tags an den QR-Codes des Kontos auf. Bewusst nur lesend – Tags entstehen, wenn Sie einen an einen QR-Code hängen, nicht über einen Erstellungsaufruf |
update_qr_tags | Destruktiv | Ersetzt die Tags eines QR-Codes durch die angegebenen (eine leere Liste entfernt alle). Noch nicht vorhandene Tags werden angelegt |
Papierkorb und Zustand
| Tool | Typ | Beschreibung |
|---|---|---|
list_trashed_qr_codes | Nur lesend | Listet QR-Codes im Papierkorb auf – gelöscht, aber noch wiederherstellbar –, jeweils mit Löschzeitpunkt und Anzahl der Scans |
restore_qr_codes | Schreibend | Stellt QR-Codes anhand ihrer qrid aus dem Papierkorb wieder her, sodass sie wieder funktionieren. Wird auf die QR-Code-Limits Ihres Tarifs angerechnet und stellt nie den gesamten Papierkorb in einem Aufruf wieder her |
get_qr_health | Nur lesend | Führt die Zustandsprüfung für die QR-Codes des Kontos aus: Probleme, die verhindern, dass Codes wie vorgesehen funktionieren, etwa inaktive oder abgelaufene Codes, defekte Ziele sowie Formulare oder eigene Domains, die Aufmerksamkeit brauchen |
GS1-Rückrufe
| Tool | Typ | Beschreibung |
|---|---|---|
list_gs1_recalls | Nur lesend | Listet die GS1-Rückrufmeldungen des Kontos für Chargen/Lose auf – welche GTIN und Charge, die Meldung, die Personen beim Scannen eines betroffenen Produkts sehen, und ob die jeweilige Meldung aktiv ist |
create_gs1_recall | Schreibend | Ruft eine Produktcharge zurück: Wer einen GS1-QR-Code für diese GTIN und Charge/dieses Los scannt, sieht stattdessen Ihre Meldung |
update_gs1_recall | Destruktiv | Ändert den Text einer Rückrufmeldung oder schaltet sie ab, sobald der Rückruf beendet ist. Ihr Verlauf bleibt erhalten |
Ordner
| Tool | Typ | Beschreibung |
|---|---|---|
create_folder | Schreibend | Erstellt einen neuen Ordner zur Organisation von QR-Codes oder Pages |
list_folders | Nur lesend | Listet alle Ordner eines bestimmten Typs auf (qr oder page) |
update_folder | Schreibend | Benennt einen bestehenden Ordner um |
delete_folder | Destruktiv | Löscht einen Ordner. Das Tool fragt vorher, was mit den enthaltenen QR-Codes geschehen soll – nach Uncategorized verschieben oder mit dem Ordner löschen |
move_qr_codes_to_folder | Schreibend | Verschiebt mehrere QR-Codes in einen Ordner |
unassign_qr_codes_from_folder | Schreibend | Entfernt mehrere QR-Codes aus einem Ordner (sie werden zu Uncategorized) |
Formulare
| Tool | Typ | Beschreibung |
|---|---|---|
list_forms | Nur lesend | Listet alle Lead-Capture-Formulare auf, optional gefiltert nach Aktivstatus |
retrieve_form | Nur lesend | Ruft detaillierte Informationen zu einem bestimmten Formular ab, einschließlich seiner Konfiguration |
create_form | Schreibend | Erstellt ein Formular aus einem Titel und seinen Fragen – jeweils mit einem Antworttyp (Kurzantwort, E-Mail, Multiple Choice, Sternebewertung und mehr) und Optionen für Auswahlfragen – und verknüpft es direkt mit einem dynamischen QR-Code, wenn Sie einen mitgeben. Akzeptiert auch die vollständige Blockstruktur eines Formulars |
update_form | Destruktiv | Aktualisiert den Namen oder Aktivstatus eines Formulars |
delete_form | Destruktiv | Löscht ein Formular dauerhaft |
attach_form_to_qr | Schreibend | Verknüpft ein Lead-Capture-Formular mit einem QR-Code, anhand der numerischen id oder der form_id des Formulars |
detach_form_from_qr | Destruktiv | Entfernt das Lead-Capture-Formular von einem QR-Code |
list_form_templates | Nur lesend | Listet fertige Formularvorlagen auf, mit denen Sie ein neues Formular beginnen können |
list_form_responses | Nur lesend | Listet die Antworten auf, die ein Formular gesammelt hat, die neuesten zuerst: die Angaben, wann sie jeweils eingingen und über welchen QR-Code. Filtert nach Zeitraum, QR-Code oder Suchbegriff |
get_form_analytics | Nur lesend | Ruft die Performance eines Formulars ab: Antworten und Übersprünge insgesamt im Vergleich zum vorherigen Zeitraum, jeweils nach Datum, sowie Antworten nach Quell-QR-Code |
get_form_question_analytics | Nur lesend | Ruft ab, wie jede Frage eines Formulars beantwortet wurde: wie viele Antworten sie beantwortet haben und bei Auswahl-, Bewertungs- und Skalenfragen, wie oft jede Antwortmöglichkeit gewählt wurde |
list_form_notifications | Nur lesend | Listet die E-Mail-Benachrichtigungen für neue Formularantworten auf – an wen sie gehen, wie oft, für welche Formulare und ob sie jeweils aktiv sind |
create_form_notification | Schreibend | Benachrichtigt jemanden per E-Mail, wenn Formulare neue Antworten erhalten – bei jeder Antwort oder als tägliche, wöchentliche oder monatliche Zusammenfassung. Die Adresse erhält die Angaben der Befragten |
update_form_notification | Destruktiv | Ändert Empfänger, Häufigkeit oder Formulare einer Formular-Benachrichtigung oder schaltet sie ab. Ihre Formulare bleiben erhalten, sofern Sie keine neuen angeben |
Lead-Listen
| Tool | Typ | Beschreibung |
|---|---|---|
list_lead_lists | Nur lesend | Listet alle Lead-Listen auf, optional gefiltert nach Aktivstatus. Für neue Projekte sind Formulare das Mittel der Wahl |
retrieve_lead_list | Nur lesend | Ruft detaillierte Informationen zu einer bestimmten Lead-Liste ab, einschließlich ihrer Webhook-Konfiguration |
update_lead_list | Destruktiv | Aktualisiert den Namen oder Aktivstatus einer Lead-Liste |
delete_lead_list | Destruktiv | Löscht eine Lead-Liste dauerhaft |
attach_lead_list_to_qr | Schreibend | Verknüpft eine Lead-Liste zur Lead-Erfassung mit einem QR-Code |
detach_lead_list_from_qr | Destruktiv | Entfernt die Lead-Liste von einem QR-Code |
Analysen und Berichte
| Tool | Typ | Beschreibung |
|---|---|---|
get_account_stats | Nur lesend | Ruft kontobezogene Nutzungszähler ab – Gesamtzahl der QR-Codes, Scans, Benutzer usw |
get_qr_analytics | Nur lesend | Ruft Performance-Kennzahlen eines QR-Codes ab, aufgeschlüsselt nach Gerät, Geografie, Datum und weiteren Dimensionen |
get_analytics_overview | Nur lesend | Ruft die Scan-Übersicht des Kontos ab: Gesamtwerte seit Beginn, der laufende Monat, die letzten Monate und Scans nach Datum |
list_analytics_reports | Nur lesend | Listet die für das Konto erstellten Scan-Analyseberichte auf, jeweils mit Umfang, Zeitraum, Status und – sobald fertig – einem Download-Link |
create_analytics_report | Schreibend | Erstellt einen Scan-Analysebericht – zusammengefasste Analysen, Rohdaten der Scans oder beides – für ausgewählte QR-Codes, Tags oder Ordner über einen Zeitraum. Er wird im Hintergrund erstellt und an die anfragende Person gemailt |
Tarif und Abrechnung
Nur lesend: Der Assistent kann Tarif und Abrechnungsverlauf erklären, Änderungen am Abonnement bleiben aber der App vorbehalten.| Tool | Typ | Beschreibung |
|---|---|---|
get_current_plan | Nur lesend | Ruft den aktiven Tarif des Kontos ab – Ablauf, Abrechnungsstatus und die vollständige Liste der gewährten Kontingente |
list_available_plans | Nur lesend | Listet die Tarife auf, zu denen das Konto wechseln kann, mit ihren Funktionen und Kontingenten |
get_downgrade_impact | Nur lesend | Zeigt vor einem Wechsel in einen kleineren Tarif, welche QR-Codes, Benutzer, Domains und anderen Ressourcen des Kontos diesen Tarif überschreiten |
list_payments | Nur lesend | Listet den Zahlungsverlauf des Kontos auf – Betrag, Datum und Status jeder Zahlung |
list_orders | Nur lesend | Listet die Bestellungen des Kontos auf – Tarifkäufe, Verlängerungen und Aufstockungen – sowie deren Status |
list_quota_topups | Nur lesend | Listet zusätzlich zum Tarif gekaufte Kontingente auf und wann jede Aufstockung ausläuft |
Benutzer und Rollen
| Tool | Typ | Beschreibung |
|---|---|---|
list_users | Nur lesend | Listet alle Benutzer im Konto auf |
get_user | Nur lesend | Ruft die Details eines bestimmten Benutzers ab |
add_user | Schreibend | Lädt einen neuen Benutzer per E-Mail zum Konto ein |
resend_user_invitation | Schreibend | Sendet die Einladungs-E-Mail eines Teammitglieds erneut, wenn es die Einladung noch nicht angenommen hat |
remove_user | Destruktiv | Entfernt einen Benutzer aus dem Konto |
list_user_roles | Nur lesend | Listet alle zuweisbaren Benutzerrollen auf |
create_custom_role | Schreibend | Erstellt eine eigene Rolle. Erfordert ein eigenes Tarif-Kontingent und liefert 403, wenn der Tarif es nicht gewährt. Rufen Sie zuerst list_user_roles auf, um zu sehen, was es schon gibt |
update_user_role | Destruktiv | Ändert die Rolle eines bestehenden Benutzers |
Aktivität
| Tool | Typ | Beschreibung |
|---|---|---|
get_activity_feed | Nur lesend | Listet auf, was im Konto passiert ist – wer was erstellt, geändert oder gelöscht hat und wann –, gefiltert nach Ereignistyp, Teammitglied oder Datum |
get_activity_summary | Nur lesend | Ruft Kennzahlen zur Aktivität im Konto über einen Zeitraum ab |
Eigene Domains
| Tool | Typ | Beschreibung |
|---|---|---|
list_custom_domains | Nur lesend | Listet die eigenen Kurzlink-Domains des Kontos auf (zum Beispiel qr.example.com), welche davon die Standarddomain ist und ob jede verifiziert ist |
get_custom_domain | Nur lesend | Ruft die Details einer eigenen Domain ab – ihre DNS-Verifizierung (TXT/CNAME), den SSL-Status und ob sie die Standarddomain ist |
Bulk-Operationen und Medien
| Tool | Typ | Beschreibung |
|---|---|---|
list_bulk_operations | Nur lesend | Listet die Bulk-Operationen des Kontos auf – Massenerstellung und -aktualisierung von QR-Codes –, jeweils mit Status und Ergebnissen |
get_bulk_operation_stats | Nur lesend | Ruft Gesamtwerte über alle Bulk-Operationen des Kontos ab |
list_media | Nur lesend | Listet Dateien in der Media Library des Kontos auf – Bilder, PDFs, Videos und mehr –, etwa um ein Logo oder ein Dokument für einen QR-Code auszuwählen |
Integrationen und Konversionsverfolgung
| Tool | Typ | Beschreibung |
|---|---|---|
get_integrations_overview | Nur lesend | Zeigt, welche Integrationen das Konto verbunden hat – Webhooks, Zapier, Slack, HubSpot, Google Analytics – und ihren Status |
list_webhooks | Nur lesend | Listet die Webhooks des Kontos auf: wohin jeder Ereignisse sendet, für welche Formulare oder QR-Codes und ob er aktiv ist |
list_tracking_sites | Nur lesend | Listet die für die Konversionsverfolgung eingerichteten Websites mit ihren Domains auf |
list_tracking_funnels | Nur lesend | Listet die Konversionstrichter einer Tracking-Website auf – die Schritte vom Scan bis zur Konversion |
Landingpages
| Tool | Typ | Beschreibung |
|---|---|---|
list_page_templates | Nur lesend | Listet Landingpage-Vorlagen für QR-Codes auf, die eine Seite öffnen – Scanovas eigene oder nur die im Konto gespeicherten |
Destruktive Tools überspringen bewusst einen Bestätigungsdialog — das MCP-Protokoll kennt keinen eingebauten Schritt “Sind Sie sicher?”; welche Bestätigung stattfindet, richtet sich allein nach den Konventionen Ihres KI-Clients. Prüfen Sie, was ein Aufruf von
delete_*, update_* oder remove_user gerade tun will, bevor Sie ihn freigeben — genauso wie bei jeder anderen schreibenden Aktion, die Sie an einen Assistenten delegieren.Weiterführende Informationen
- MCP-Überblick — was der Server ist, was er auf einen Blick kann, und seine Zugangsvoraussetzungen
- MCP-Setup — einen KI-Client mit dem Server verbinden, der diese Tools bereitstellt
- Management-API im Überblick — die zugrunde liegende API, die diese Tools in Ihrem Namen aufrufen