Spartoo biedt een MCP-server (Model Context Protocol) waarmee een AI-assistent (Claude, ChatGPT, Cursor...) de catalogus van de site in alleen-lezen modus kan raadplegen: productzoeken, productdetails en beschikbare filters. De prijzen en voorraad zijn die van Spartoo, in EUR.
Spartoo MCP-serveradres:
https://www.spartoo.nl/mcp
Er is één server per site en per land: elke site heeft zijn eigen adres, met zijn eigen catalogus, prijzen en valuta. Gebruik het adres van de site waarop u producten wilt zoeken.
claude mcp add --transport http spartoo https://www.spartoo.nl/mcp
Zodra de server is verbonden, stelt u eenvoudig uw vraag aan de assistent, bijvoorbeeld: "Vind witte damessneakers in maat 38 op Spartoo".
Aangezien de tools alleen-lezen zijn, kunt u ze instellen op "Altijd toestaan" in de instellingen van de connector (Claude) of in de machtigingen van uw client, om te voorkomen dat u bij elke zoekopdracht om toestemming wordt gevraagd.
De tools zijn alleen-lezen. Typische volgorde: beschikbare zoekfilters ontdekken, producten zoeken met deze filters, en vervolgens de details van een gekozen product weergeven.
list_filters → search_products → get_product
list_filtersGeeft een lijst met beschikbare waarden om een zoekopdracht te verfijnen: merken, kleuren, maten, geslachten, categorieën (met aantal producten indien bekend), prijsbereik en het totaal aantal producten. Te gebruiken vóór het zoeken naar producten, om keuzes voor te stellen of te controleren of een waarde bestaat. Een zoekopdracht die te breed is (zonder categorie, merk of bekend trefwoord) wordt geweigerd met een bericht: deze moet dan worden gepreciseerd.
Argumenten: query (verplicht), gender, brand, color, size, price_min, price_max
search_productsZoek producten met vrije tekst, zoals die zou worden ingevoerd in de zoekmachine van de site en in de taal daarvan. Woorden voor merk, categorie, kleur en geslacht worden filters; optionele argumenten vervangen of verfijnen de zoekopdracht (maat op voorraad, prijs in de valuta van de site, sortering). De resultaten zijn gepagineerd (tot 50 producten per pagina) en geven aan hoe de zoekopdracht werd begrepen.
Argumenten: query (verplicht), gender, brand, color, size, price_min, price_max, sort, page, page_size
get_productGeeft de volledige productfiche terug, of maximaal 10 producten om ze te vergelijken, op basis van de ID's die door de zoekopdracht zijn geretourneerd: beschrijving, prijs, maten en hun beschikbaarheid, foto's, andere kleuren van hetzelfde model en kenmerken (materialen, hakhoogte, land van fabricage...).
Argumenten: product_id, product_ids
De server vraagt geen persoonlijke gegevens en heeft geen toegang tot klantaccounts. Voor servicebewaking en beveiliging wordt elke aanroep gelogd met: de gedetecteerde AI-assistent (clientnaam en versie), de user-agent, het IP-adres, de aangeroepen methode en tool met hun argumenten, de status en de duur van de respons. De inhoud van de antwoorden wordt niet gelogd.
Voor meer informatie kunt u onze privacyverklaring raadplegen.
Heb je een vraag of probleem met de MCP-server? Neem contact op met onze klantenservice.