MCP-Server

shop

de.tabak-brucker.www/shop
Commerce & Retail Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Provides product catalog search, product details, recommendations, offers, availability, customer support, loyalty and order information, and checkout hand-offs for a tobacco retailer.

check_availability
Verfuegbarkeit pruefen
Prueft, wie viele Einheiten eines Artikels aktuell bestellbar sind (unter Beruecksichtigung von Bestand und Lieferstatus).
Eingabeschema
{'type': 'object', 'required': ['artikel_id'], 'properties': {'menge': {'type': 'integer', 'minimum': 1, 'description': 'Gewuenschte Menge (Default 1).'}, 'artikel_id': {'type': 'integer', 'description': 'Artikel-ID.'}}}
contact_support
Kontakt / Support
Leitet eine Kundenanfrage als Ticket an das Team weiter. Erfordert eine gueltige E-Mail fuer die Rueckmeldung.
Eingabeschema
{'type': 'object', 'required': ['nachricht', 'email'], 'properties': {'name': {'type': 'string', 'description': 'Name (optional).'}, 'email': {'type': 'string', 'description': 'Gueltige E-Mail fuer die Rueckmeldung.'}, 'thema': {'type': 'string', 'description': 'Betreff (optional).'}, 'nachricht': {'type': 'string', 'description': 'Die Anfrage/Nachricht.'}}}
create_cart
Warenkorb anlegen (Checkout-Link)
Legt einen vorbereiteten Warenkorb an und gibt eine Checkout-URL zurueck. WICHTIG: schliesst KEINE Bestellung ab — der Kunde muss die URL im Browser oeffnen und dort Login, Altersnachweis und Zahlung durchlaufen.
Eingabeschema
{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['artikel_id'], 'properties': {'menge': {'type': 'integer', 'minimum': 1, 'description': 'Menge (Default 1).'}, 'artikel_id': {'type': 'integer', 'description': 'Artikel-ID.'}}}, 'description': 'Positionen (max. 50).'}}}
get_guide
Ratgeber-Artikel lesen
Liefert den vollstaendigen Text eines Ratgeber-Artikels (per ID oder URL-Slug) als Klartext, damit die KI damit fundiert beraten kann.
Eingabeschema
{'type': 'object', 'properties': {'id': {'type': 'integer', 'description': 'ratgeber_id (aus search_guides).'}, 'url': {'type': 'string', 'description': 'URL-Slug des Artikels (Alternative zur id).'}}}
get_loyalty
Meine Treuepunkte
Treuepunkte-Stand, Stufe und einloesbare Praemien des verknuepften Kunden. Erfordert ein via link_account verknuepftes token.
Eingabeschema
{'type': 'object', 'required': ['token'], 'properties': {'token': {'type': 'string', 'description': 'session_token aus link_account.'}}}
get_pickup_info
Abholung (Click & Collect)
Informationen zur Abholung in der Tabak Brucker Genusswelt inkl. naechster verfuegbarer Abholtermine.
Eingabeschema
{'type': 'object', 'properties': {}}
get_product
Produktdetails
Ein einzelnes Produkt per ID oder Artikelnummer (SKU) mit Preis, Verfuegbarkeit, Marke, Bild, Grundpreis und Gebinde-Infos.
Eingabeschema
{'type': 'object', 'properties': {'id': {'type': 'integer', 'description': 'Artikel-ID.'}, 'sku': {'type': 'string', 'description': 'Artikelnummer (falls keine ID bekannt).'}}}
get_recommendations
Empfehlungen
Aehnliche, lieferbare Produkte zu einem Artikel (gleicher Hersteller, Top-Seller).
Eingabeschema
{'type': 'object', 'required': ['artikel_id'], 'properties': {'artikel_id': {'type': 'integer', 'description': 'Anker-Artikel-ID.'}}}
get_reviews
Kundenbewertungen
Gepruefte Kundenbewertungen von Trusted Shops: Gesamtnote, Anzahl und die juengsten Rezensionstexte mit Datum. Quelle und Stand werden mitgeliefert.
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Anzahl Rezensionstexte, 1 bis 20 (Standard 5).'}}}
get_shop_info
Shop-Infos
Oeffentliche Shop-/Kontaktdaten aus den Sonderseiten (Impressum, AGB, Zahlungsbedingungen, Versand ...). Ohne 'thema' wird die Seitenliste zurueckgegeben.
Eingabeschema
{'type': 'object', 'properties': {'thema': {'type': 'string', 'description': 'z.B. impressum, agb, zahlungsbedingungen, versand, kontakt.'}}}
get_variants
Produktvarianten
Alle Varianten (z.B. Stange/Packung) der Versionsgruppe eines Artikels mit Gebinde und Umrechnungsfaktor.
Eingabeschema
{'type': 'object', 'required': ['artikel_id'], 'properties': {'artikel_id': {'type': 'integer', 'description': 'Artikel-ID eines Produkts der Gruppe.'}}}
link_account
Konto verknuepfen
Startet die Verknuepfung eines Kundenkontos: liefert eine Login-URL (fuer den Kunden im Browser) und ein session_token. Nach dem Login im Browser koennen list_orders/get_loyalty/request_address_change mit diesem token genutzt werden.
Eingabeschema
{'type': 'object', 'properties': {}}
list_bestsellers
Bestseller
Meistverkaufte, lieferbare Artikel (letzte 90 Tage), optional je Kategorie. Gut fuer Empfehlungen und Einstiegsfragen.
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Max. Artikel (1-30, Default 12).'}, 'kategorie_id': {'type': 'integer', 'description': 'Optional: nur diese Kategorie.'}}}
list_categories
Kategorien
Alle Shop-Kategorien (Name, ID, URL, Parent) fuer die Navigation.
Eingabeschema
{'type': 'object', 'properties': {}}
list_offers
Aktuelle Angebote
Aktuell reduzierte Artikel (aktive Sonderpreise), nach Beliebtheit sortiert. Preise sind bereits die Angebotspreise.
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Max. Artikel (1-30, Default 12).'}}}
list_orders
Meine Bestellungen
Bestellungen des verknuepften Kunden inkl. Status, Zahlstatus und Lieferstatus/Sendungsverfolgung. Erfordert ein via link_account verknuepftes token.
Eingabeschema
{'type': 'object', 'required': ['token'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max. Bestellungen (1-20, Default 10).'}, 'suche': {'type': 'string', 'description': 'Optional: nach Auftragsnummer/Artikel filtern.'}, 'token': {'type': 'string', 'description': 'session_token aus link_account (nach Browser-Login).'}}}
list_products
Produkte auflisten
Paginierte Produktliste, optional gefiltert nach Kategorie oder Marke.
Eingabeschema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Seite (Default 1).'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Treffer pro Seite (1-100, Default 50).'}, 'marke_id': {'type': 'integer', 'description': 'Nur Produkte dieser Marken-ID.'}, 'kategorie_id': {'type': 'integer', 'description': 'Nur Produkte dieser Kategorie-ID.'}}}
request_address_change
Adressaenderung anfragen
Fragt eine Lieferadressaenderung fuer eine noch nicht versandte Bestellung des verknuepften Kunden an (Ticket ans Team). Erfordert ein via link_account verknuepftes token.
Eingabeschema
{'type': 'object', 'required': ['token', 'neue_adresse'], 'properties': {'token': {'type': 'string', 'description': 'session_token aus link_account.'}, 'auftrag': {'type': 'string', 'description': 'Optional: Auftragsnummer (sonst neueste offene Bestellung).'}, 'neue_adresse': {'type': 'string', 'description': 'Vollstaendige neue Lieferadresse.'}}}
search_guides
Ratgeber durchsuchen
Durchsucht den Tabak-Brucker Ratgeber/Blog (Anleitungen, Kaufberatung, Pflege, Wissen). Ideal, um Kundenfragen mit den Inhalten des Shops zu beantworten. Ohne query = neueste Beitraege.
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max. Treffer (1-20, Default 8).'}, 'query': {'type': 'string', 'description': "Suchbegriff/Thema (z.B. 'Pfeife stopfen', 'Einsteiger', 'Lagerung')."}}}
search_products
Produkte suchen
Volltextsuche im Produktkatalog (Name, Artikelnummer, EAN). Gibt passende Produkte mit Preis und Verfuegbarkeit zurueck.
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max. Treffer (1-50, Default 20).'}, 'query': {'type': 'string', 'description': 'Suchbegriff (min. 2 Zeichen).'}}}
Hinzugefügt
list_bestsellers
17. September 2026 12:39
Hinzugefügt
list_offers
17. September 2026 12:39
Hinzugefügt
get_guide
17. September 2026 12:39
Hinzugefügt
search_guides
17. September 2026 12:39
Hinzugefügt
request_address_change
17. September 2026 12:39
Hinzugefügt
get_loyalty
17. September 2026 12:39
Hinzugefügt
list_orders
17. September 2026 12:39
Hinzugefügt
link_account
17. September 2026 12:39
Hinzugefügt
contact_support
17. September 2026 12:39
Hinzugefügt
create_cart
17. September 2026 12:39
Hinzugefügt
get_pickup_info
17. September 2026 12:39
Hinzugefügt
get_reviews
17. September 2026 12:39
Hinzugefügt
get_shop_info
17. September 2026 12:39
Hinzugefügt
check_availability
17. September 2026 12:39
Hinzugefügt
get_recommendations
17. September 2026 12:39
Hinzugefügt
get_variants
17. September 2026 12:39
Hinzugefügt
list_categories
17. September 2026 12:39
Hinzugefügt
get_product
17. September 2026 12:39
Hinzugefügt
list_products
17. September 2026 12:39
Hinzugefügt
search_products
17. September 2026 12:39