MCP Shop docs

Snel uitproberen

Zonder MCP-client: gebruik de live catalogus op de website (zelfde data). Voorbeeldqueries: Voorbeelden.

MCP tools

Tool	Gebruik
search	OpenAI-compatibele zoekactie → id / title / primary buy-url (default merchant)
fetch	Details op EAN + metadata.offers[] + metadata.description
search_products	Filters (merk, categorie, prijs, feedGroup) + offers[]
get_product	Volledige catalogusrij incl. description + offers[] + buyUrl
get_price_history	Prijswijzigingen (Bol-spiegel)
get_buy_link	Tracked URL; optioneel merchant (anders goedkoopste in_stock)

Endpoint: POST http://mcp-shop.nl/mcp (Streamable HTTP). Productie: https://mcp-shop.nl/mcp.

Website-spiegel (browser): GET /catalog/public/search?q= en GET /catalog/public/products/{ean}.

Belangrijke uitvoervelden

fetch (OpenAI-shape)

Veld	Betekenis
id	EAN
title	Producttitel
text	Korte samenvatting voor clients
url	Buy-link van de default merchant
metadata.description	Volledige productbeschrijving (kan leeg zijn)
metadata.offers[]	Alle merchants: prijs, availability, merchant-specifieke URL
metadata.defaultMerchant	Gekozen standaardmerchant (goedkoopste in_stock)
metadata.variants[]	Sibling-EANs (kleur/maat) indien bekend

get_product

Zelfde catalogusrij als intern model: o.a. ean, title, description, brandName, categoryPath, imageUrl, offers[], buyUrl, defaultMerchant.

Productbeschrijving (description)

Tool	Veld
fetch	metadata.description — platte producttekst uit de catalogus
get_product	description op de productrij

• Kan null of leeg zijn (nog niet gevuld of bron zonder tekst). Verzin dan geen beschrijving.
• search / search_products leveren geen volledige description; gebruik fetch of get_product op de EAN.
• fetch.text is een korte samenvatting voor OpenAI-shape clients; de volledige catalogustekst zit in metadata.description.

Buy-links

Pad	Betekenis
/go/catalog/{ean}/{merchant}	Canonieke link naar die shop (affiliate-tracked)
/go/catalog/{ean}	Fallback: default-offer (goedkoopste in_stock)

Voorbeelden:

• http://mcp-shop.nl/go/catalog/8710103899999/bol
• http://mcp-shop.nl/go/catalog/8710103899999/demo-shop

Demo-seed: EAN 8710103899999 heeft offers van bol én demo-shop (Awin).

Agent-richtlijnen

1. Toon alle offers als offers[] meer dan één merchant bevat.
2. Link altijd merchant-specifiek — niet alleen de primary/search-URL.
3. Gebruik description voor productuitleg; verzin niets als het veld ontbreekt.
4. Vermeld kort dat koop-links affiliate kunnen zijn.
5. Deel geen API-keys, tokens of interne env.

Affiliate disclosure

MCP Shop is geen webshop. We tonen een vergelijking van aanbieders (o.a. Bol en Awin-advertisers). Elke koop-link loopt via ons redirect-endpoint en kan affiliate-tracking bevatten; wij kunnen een vergoeding ontvangen als je via zo’n link iets koopt.

Kliks worden intern gelogd (EAN, merchant, netwerk, gehashte IP, user-agent) voor fraude- en kwaliteitscontrole — zie ook de privacyverklaring. Prijzen en voorraad kunnen wijzigen.

Gebruik MCP Shop in je AI

• MCP-endpoint: https://mcp-shop.nl/mcp
• Installatie-instructies voor ChatGPT, Cursor, Claude en andere clients
• Algemene MCP-config downloaden
• Cursor-config downloaden

De gebruiker moet MCP Shop zelf toevoegen of inschakelen; alleen de website bezoeken of een configuratie downloaden activeert de server niet automatisch.