MCP-Tools Referenz

Der MCP-Server ist unter /mcp erreichbar und stellt folgende Tools bereit. Öffentliche Tools sind ohne Login nutzbar; authentifizierte Tools erfordern ein Bearer-Token (OAuth PKCE).

Öffentliche Tools

Keine Authentifizierung erforderlich.

`list_items`

Gibt alle aktiven Geräte zurück. Nur aufrufen wenn der Nutzer explizit die komplette Geräteübersicht möchte — für gezielte Suchen besser search_items verwenden.

Keine Parameter

Gibt zurück: Array mit id, name, pricePerDay, pricePerWeek, pricePerWeekend, deposit, description, itemUrl, thumbnailUrl

`search_items`

Hybrid-Suche (70% semantisch via Jina + 30% lexikal). Findet Geräte nach Stichwort, Konzept oder Tag. Standard-Limit: 5 Treffer.

Parameter	Typ	Pflicht	Beschreibung
`query`	string	ja	Suchbegriff oder -konzept
`tags`	string[]	nein	Nur Geräte mit allen angegebenen Tags
`limit`	number	nein	Maximale Trefferzahl (1–20, Standard: 5)

Gibt zurück: Array mit id, name, pricePerDay, pricePerWeekend, pricePerWeek, tags, score

`list_sets`

Gibt alle verfügbaren Gerätesets zurück. Sets sind Bündel aus mehreren Geräten zu einem gemeinsamen Tagespreis.

Keine Parameter

Gibt zurück: Array mit id, name, description, pricePerDay, deposit

`get_item`

Zeigt alle Details eines bestimmten Geräts inkl. Bilderliste.

Parameter	Typ	Pflicht	Beschreibung
`id`	string	ja	Geräte-ID

Gibt zurück: id, name, pricePerDay, pricePerWeek, pricePerWeekend, deposit, description, thumbnailUrl, images[], itemUrl, productUrl

`check_availability`

Prüft, ob ein Gerät oder Set in einem bestimmten Zeitraum verfügbar ist.

Parameter	Typ	Pflicht	Beschreibung
`deviceId`	string	bedingt	Geräte-ID (oder setId)
`setId`	string	bedingt	Set-ID (oder deviceId)
`startDate`	string	ja	Startdatum `YYYY-MM-DD`
`endDate`	string	ja	Enddatum `YYYY-MM-DD`

Gibt zurück: { available: boolean }

Authentifizierte Tools

Diese Tools erfordern ein gültiges Bearer-Token. Ohne Token wird { error: "Nicht angemeldet" } zurückgegeben.

Buchungsverwaltung

`create_booking`

Erstellt eine Buchungsanfrage. Der Owner erhält eine E-Mail mit Approve/Reject-Link. Genau eines von deviceId oder setId ist erforderlich.

Parameter	Typ	Pflicht	Beschreibung
`deviceId`	string	bedingt	Geräte-ID
`setId`	string	bedingt	Set-ID
`startDate`	string	ja	Startdatum `YYYY-MM-DD`
`endDate`	string	ja	Enddatum `YYYY-MM-DD`
`firstName`	string	ja	Vorname des Mieters
`lastName`	string	ja	Nachname des Mieters
`phone`	string	ja	Telefonnummer des Mieters
`notes`	string	nein	Hinweise zur Buchung

Gibt zurück: { bookingId: string, status: "pending" }

`get_my_bookings`

Zeigt alle Buchungen des eingeloggten Nutzers als Mieter. Bei genehmigten Buchungen werden Abholadresse und Telefon des Owners mitgeliefert.

Keine Parameter

Gibt zurück: Array mit id, deviceId, setId, startDate, endDate, status (+ pickupAddress, ownerPhone bei approved)

`cancel_booking`

Storniert eine Buchung. Mieter und Owner können jeweils stornieren. Beide Parteien werden per E-Mail benachrichtigt.

Parameter	Typ	Pflicht	Beschreibung
`bookingId`	string	ja	ID der Buchung

Gibt zurück: { status: "cancelled" }

`approve_booking` nur Owner

Bestätigt eine ausstehende Buchungsanfrage. Nur der Owner des Geräts darf genehmigen.

Parameter	Typ	Pflicht	Beschreibung
`bookingId`	string	ja	ID der Buchung

Gibt zurück: { status: "approved" }

`reject_booking` nur Owner

Lehnt eine ausstehende Buchungsanfrage ab. Nur der Owner des Geräts darf ablehnen.

Parameter	Typ	Pflicht	Beschreibung
`bookingId`	string	ja	ID der Buchung

Gibt zurück: { status: "rejected" }

`get_owner_bookings` nur Owner

Zeigt alle Buchungen auf den eigenen Geräten (alle Status).

Keine Parameter

Gibt zurück: Array mit id, deviceId, deviceName, startDate, endDate, firstName, lastName, phone, status

Geräteverwaltung

`create_item` Uploader-Berechtigung

Legt ein neues Gerät an. Erfordert die can_upload-Berechtigung (muss vom Admin freigeschaltet werden).

Parameter	Typ	Pflicht	Beschreibung
`name`	string	ja	Name des Geräts
`pricePerDay`	number	ja	Tagespreis in Euro
`pricePerWeek`	number	nein	Wochenpreis in Euro
`pricePerWeekend`	number	nein	Wochenendpreis in Euro
`deposit`	number	nein	Kaution in Euro
`productUrl`	string	nein	Link zum Produkt
`description`	string	nein	Beschreibung
`tags`	string[]	nein	Schlagwörter (werden klein geschrieben)

Gibt zurück: { itemId: string }

`update_item` nur Owner des Geräts

Aktualisiert ein eigenes Gerät. Alle Parameter außer id sind optional.

Parameter	Typ	Pflicht	Beschreibung
`id`	string	ja	Geräte-ID
`name`	string	nein	Neuer Name
`pricePerDay`	number	nein	Neuer Tagespreis
`pricePerWeek`	number	nein	Neuer Wochenpreis
`pricePerWeekend`	number	nein	Neuer Wochenendpreis
`deposit`	number	nein	Neue Kaution
`description`	string	nein	Neue Beschreibung
`active`	boolean	nein	Aktiv/Inaktiv schalten
`tags`	string[]	nein	Neue Schlagwörter
`thumbnailPath`	string	nein	Neuer Thumbnail-Pfad

Gibt zurück: { success: true, item: ... }

`list_my_items` nur Owner

Zeigt alle eigenen Geräte (auch inaktive).

Keine Parameter

Gibt zurück: Array mit id, name, pricePerDay, active, thumbnailUrl u.a.

`attach_image_to_item` Uploader-Berechtigung

Verknüpft ein hochgeladenes Bild (via POST /images/upload) mit einem Gerät und setzt es optional als Thumbnail.

Parameter	Typ	Pflicht	Beschreibung
`itemId`	string	ja	Geräte-ID
`imageId`	string	ja	Bild-ID (vom Upload zurückgegeben)
`setAsThumbnail`	boolean	nein	Als Thumbnail setzen

Gibt zurück: { success: true, imageId, path, url?, thumbnailSet }

Profilverwaltung

`get_profile`

Gibt das eigene Profil zurück (Name, E-Mail, Telefon, Adresse).

Keine Parameter

Gibt zurück: name, email, phone, addressStreet, addressZip, addressCity

`update_profile`

Aktualisiert das eigene Profil. Alle Parameter sind optional.

Parameter	Typ	Pflicht	Beschreibung
`name`	string	nein	Anzeigename
`phone`	string	nein	Telefonnummer
`addressStreet`	string	nein	Straße + Hausnummer
`addressZip`	string	nein	Postleitzahl
`addressCity`	string	nein	Stadt

Gibt zurück: Aktualisiertes Profil-Objekt

Admin-Tools

`admin_approve_uploader` nur Admin

Gibt einen Nutzer als Vermieter frei (setzt can_upload = true).

Parameter	Typ	Pflicht	Beschreibung
`userIdOrEmail`	string	ja	User-ID oder E-Mail-Adresse

Gibt zurück: { ok: true, userId, email, canUpload: true }

`admin_revoke_uploader` nur Admin

Entzieht einem Nutzer die Vermieter-Berechtigung.

Parameter	Typ	Pflicht	Beschreibung
`userIdOrEmail`	string	ja	User-ID oder E-Mail-Adresse
`reason`	string	nein	Begründung (optional)

Gibt zurück: { ok: true, userId, email, canUpload: false }

`admin_list_users` nur Admin

Listet alle Nutzer auf. Optionaler Filter: all | pending (ohne Uploader-Recht) | approved (mit Uploader-Recht).

Parameter	Typ	Pflicht	Beschreibung
`filter`	string	nein	`all` \| `pending` \| `approved`

Gibt zurück: Array mit id, email, name, canUpload, isAdmin, approvedAt

MCP-Tools Referenz

Öffentliche Tools

list_items

search_items

list_sets

get_item

check_availability

Authentifizierte Tools

Buchungsverwaltung

create_booking

get_my_bookings

cancel_booking

approve_booking nur Owner

reject_booking nur Owner

get_owner_bookings nur Owner

Geräteverwaltung

create_item Uploader-Berechtigung

update_item nur Owner des Geräts

list_my_items nur Owner

attach_image_to_item Uploader-Berechtigung

Profilverwaltung

get_profile

update_profile

Admin-Tools

admin_approve_uploader nur Admin

admin_revoke_uploader nur Admin

admin_list_users nur Admin

`list_items`

`search_items`

`list_sets`

`get_item`

`check_availability`

`create_booking`

`get_my_bookings`

`cancel_booking`

`approve_booking` nur Owner

`reject_booking` nur Owner

`get_owner_bookings` nur Owner

`create_item` Uploader-Berechtigung

`update_item` nur Owner des Geräts

`list_my_items` nur Owner

`attach_image_to_item` Uploader-Berechtigung

`get_profile`

`update_profile`

`admin_approve_uploader` nur Admin

`admin_revoke_uploader` nur Admin

`admin_list_users` nur Admin