Shop

Official19 tools

by www

Tabak Brucker in ChatGPT/Claude: Katalog, Beratung, Angebote & Warenkorb-Hand-off. Kauf 18+ im Shop.

Captured live from the server via tools/list.

search_products

Volltextsuche im Produktkatalog (Name, Artikelnummer, EAN). Gibt passende Produkte mit Preis und Verfuegbarkeit zurueck.

Parameters2

query	string	required	Suchbegriff (min. 2 Zeichen).
limit	integer	optional	Max. Treffer (1-50, Default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Suchbegriff (min. 2 Zeichen)."
    },
    "limit": {
      "type": "integer",
      "description": "Max. Treffer (1-50, Default 20).",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ]
}

list_products

Paginierte Produktliste, optional gefiltert nach Kategorie oder Marke.

Parameters4

kategorie_id	integer	optional	Nur Produkte dieser Kategorie-ID.
marke_id	integer	optional	Nur Produkte dieser Marken-ID.
page	integer	optional	Seite (Default 1).
limit	integer	optional	Treffer pro Seite (1-100, Default 50).

Raw schema

{
  "type": "object",
  "properties": {
    "kategorie_id": {
      "type": "integer",
      "description": "Nur Produkte dieser Kategorie-ID."
    },
    "marke_id": {
      "type": "integer",
      "description": "Nur Produkte dieser Marken-ID."
    },
    "page": {
      "type": "integer",
      "description": "Seite (Default 1).",
      "minimum": 1
    },
    "limit": {
      "type": "integer",
      "description": "Treffer pro Seite (1-100, Default 50).",
      "minimum": 1,
      "maximum": 100
    }
  }
}

get_product

Ein einzelnes Produkt per ID oder Artikelnummer (SKU) mit Preis, Verfuegbarkeit, Marke, Bild, Grundpreis und Gebinde-Infos.

Parameters2

id	integer	optional	Artikel-ID.
sku	string	optional	Artikelnummer (falls keine ID bekannt).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Artikel-ID."
    },
    "sku": {
      "type": "string",
      "description": "Artikelnummer (falls keine ID bekannt)."
    }
  }
}

list_categories

Alle Shop-Kategorien (Name, ID, URL, Parent) fuer die Navigation.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_variants

Alle Varianten (z.B. Stange/Packung) der Versionsgruppe eines Artikels mit Gebinde und Umrechnungsfaktor.

Parameters1

artikel_id

integer

required

Artikel-ID eines Produkts der Gruppe.

Raw schema

{
  "type": "object",
  "properties": {
    "artikel_id": {
      "type": "integer",
      "description": "Artikel-ID eines Produkts der Gruppe."
    }
  },
  "required": [
    "artikel_id"
  ]
}

get_recommendations

Aehnliche, lieferbare Produkte zu einem Artikel (gleicher Hersteller, Top-Seller).

Parameters1

artikel_id

integer

required

Anker-Artikel-ID.

Raw schema

{
  "type": "object",
  "properties": {
    "artikel_id": {
      "type": "integer",
      "description": "Anker-Artikel-ID."
    }
  },
  "required": [
    "artikel_id"
  ]
}

check_availability

Prueft, wie viele Einheiten eines Artikels aktuell bestellbar sind (unter Beruecksichtigung von Bestand und Lieferstatus).

Parameters2

artikel_id	integer	required	Artikel-ID.
menge	integer	optional	Gewuenschte Menge (Default 1).

Raw schema

{
  "type": "object",
  "properties": {
    "artikel_id": {
      "type": "integer",
      "description": "Artikel-ID."
    },
    "menge": {
      "type": "integer",
      "description": "Gewuenschte Menge (Default 1).",
      "minimum": 1
    }
  },
  "required": [
    "artikel_id"
  ]
}

get_shop_info

Oeffentliche Shop-/Kontaktdaten aus den Sonderseiten (Impressum, AGB, Zahlungsbedingungen, Versand ...). Ohne 'thema' wird die Seitenliste zurueckgegeben.

Parameters1

thema

string

optional

z.B. impressum, agb, zahlungsbedingungen, versand, kontakt.

Raw schema

{
  "type": "object",
  "properties": {
    "thema": {
      "type": "string",
      "description": "z.B. impressum, agb, zahlungsbedingungen, versand, kontakt."
    }
  }
}

get_pickup_info

Informationen zur Abholung am Lagerverkauf inkl. naechster verfuegbarer Abholtermine.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

create_cart

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.

Parameters1

items

array

required

Positionen (max. 50).

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Positionen (max. 50).",
      "items": {
        "type": "object",
        "properties": {
          "artikel_id": {
            "type": "integer",
            "description": "Artikel-ID."
          },
          "menge": {
            "type": "integer",
            "description": "Menge (Default 1).",
            "minimum": 1
          }
        },
        "required": [
          "artikel_id"
        ]
      }
    }
  },
  "required": [
    "items"
  ]
}

contact_support

Leitet eine Kundenanfrage als Ticket an das Team weiter. Erfordert eine gueltige E-Mail fuer die Rueckmeldung.

Parameters4

nachricht	string	required	Die Anfrage/Nachricht.
email	string	required	Gueltige E-Mail fuer die Rueckmeldung.
name	string	optional	Name (optional).
thema	string	optional	Betreff (optional).

Raw schema

{
  "type": "object",
  "properties": {
    "nachricht": {
      "type": "string",
      "description": "Die Anfrage/Nachricht."
    },
    "email": {
      "type": "string",
      "description": "Gueltige E-Mail fuer die Rueckmeldung."
    },
    "name": {
      "type": "string",
      "description": "Name (optional)."
    },
    "thema": {
      "type": "string",
      "description": "Betreff (optional)."
    }
  },
  "required": [
    "nachricht",
    "email"
  ]
}

link_account

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_orders

Bestellungen des verknuepften Kunden inkl. Status, Zahlstatus und Lieferstatus/Sendungsverfolgung. Erfordert ein via link_account verknuepftes token.

Parameters3

token	string	required	session_token aus link_account (nach Browser-Login).
suche	string	optional	Optional: nach Auftragsnummer/Artikel filtern.
limit	integer	optional	Max. Bestellungen (1-20, Default 10).

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "session_token aus link_account (nach Browser-Login)."
    },
    "suche": {
      "type": "string",
      "description": "Optional: nach Auftragsnummer/Artikel filtern."
    },
    "limit": {
      "type": "integer",
      "description": "Max. Bestellungen (1-20, Default 10).",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "token"
  ]
}

get_loyalty

Treuepunkte-Stand, Stufe und einloesbare Praemien des verknuepften Kunden. Erfordert ein via link_account verknuepftes token.

Parameters1

token

string

required

session_token aus link_account.

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "session_token aus link_account."
    }
  },
  "required": [
    "token"
  ]
}

request_address_change

Fragt eine Lieferadressaenderung fuer eine noch nicht versandte Bestellung des verknuepften Kunden an (Ticket ans Team). Erfordert ein via link_account verknuepftes token.

Parameters3

token	string	required	session_token aus link_account.
neue_adresse	string	required	Vollstaendige neue Lieferadresse.
auftrag	string	optional	Optional: Auftragsnummer (sonst neueste offene Bestellung).

Raw schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "session_token aus link_account."
    },
    "neue_adresse": {
      "type": "string",
      "description": "Vollstaendige neue Lieferadresse."
    },
    "auftrag": {
      "type": "string",
      "description": "Optional: Auftragsnummer (sonst neueste offene Bestellung)."
    }
  },
  "required": [
    "token",
    "neue_adresse"
  ]
}

search_guides

Durchsucht den Tabak-Brucker Ratgeber/Blog (Anleitungen, Kaufberatung, Pflege, Wissen). Ideal, um Kundenfragen mit den Inhalten des Shops zu beantworten. Ohne query = neueste Beitraege.

Parameters2

query	string	optional	Suchbegriff/Thema (z.B. 'Pfeife stopfen', 'Einsteiger', 'Lagerung').
limit	integer	optional	Max. Treffer (1-20, Default 8).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Suchbegriff/Thema (z.B. 'Pfeife stopfen', 'Einsteiger', 'Lagerung')."
    },
    "limit": {
      "type": "integer",
      "description": "Max. Treffer (1-20, Default 8).",
      "minimum": 1,
      "maximum": 20
    }
  }
}

get_guide

Liefert den vollstaendigen Text eines Ratgeber-Artikels (per ID oder URL-Slug) als Klartext, damit die KI damit fundiert beraten kann.

Parameters2

id	integer	optional	ratgeber_id (aus search_guides).
url	string	optional	URL-Slug des Artikels (Alternative zur id).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "ratgeber_id (aus search_guides)."
    },
    "url": {
      "type": "string",
      "description": "URL-Slug des Artikels (Alternative zur id)."
    }
  }
}

list_offers

Aktuell reduzierte Artikel (aktive Sonderpreise), nach Beliebtheit sortiert. Preise sind bereits die Angebotspreise.

Parameters1

limit

integer

optional

Max. Artikel (1-30, Default 12).

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max. Artikel (1-30, Default 12).",
      "minimum": 1,
      "maximum": 30
    }
  }
}

list_bestsellers

Meistverkaufte, lieferbare Artikel (letzte 90 Tage), optional je Kategorie. Gut fuer Empfehlungen und Einstiegsfragen.

Parameters2

kategorie_id	integer	optional	Optional: nur diese Kategorie.
limit	integer	optional	Max. Artikel (1-30, Default 12).

Raw schema

{
  "type": "object",
  "properties": {
    "kategorie_id": {
      "type": "integer",
      "description": "Optional: nur diese Kategorie."
    },
    "limit": {
      "type": "integer",
      "description": "Max. Artikel (1-30, Default 12).",
      "minimum": 1,
      "maximum": 30
    }
  }
}

Install

Tools (19)

search_productslist_productsget_productlist_categoriesget_variantsget_recommendationscheck_availabilityget_shop_info

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.tabak-brucker.de/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "shop": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tabak-brucker.de/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.