MCP-catalogus

Verbinding en protocol

Endpoint: https://createdby.you/mcp. Transport: Streamable HTTP via POST. De server gebruikt de officiële MCP TypeScript SDK 2.4 en ondersteunt de protocolversie 2026-07-28 met de stateless compatibiliteitsroute voor 2025-clients. Gebruik een actuele MCP-client die de versie onderhandelt.

De catalogus is openbaar. Er is geen OAuth, account, API-sleutel of toestemming voor privégegevens nodig. GET en DELETE hebben geen sessiefunctie op deze stateless aansluiting. De tools zijn read-only, idempotent en doen geen betaalde AI-aanroepen.

search_catalog

Zoek op onderwerp, kleur of productnaam. query is optioneel. category is wallpaper of photo_relief. Pagineer met offset en limit (standaard 8, maximaal 20 producten). Gebruik de teruggegeven next_offset voor een volgende pagina.

{
  "query": "groen",
  "category": "wallpaper",
  "limit": 5
}

Het resultaat bevat product-ID’s, bijpassende varianten, variant-ID’s, product- en beeldlinks, maat, materiaal, beschikbaarheid en prijscontext. Een lege productlijst is een geldige zoekuitkomst.

get_product

Geef een id uit de zoekuitkomst mee: een product_id of variant_id. Je krijgt het openbare product met alle actuele varianten en links naar verzending, retour/garantie en privacy. Bij een variant-ID wijst selected_variant_id de bedoelde variant aan.

{
  "id": "lijnportret-in-relief"
}

Prijs en maat blijven bij elkaar

Schema: createdby-public-catalog/1. Markt: Nederland. Bedragen staan in eurocenten in amount_minor, valuta EUR, inclusief btw. price.basis is selected_variant: de prijs geldt voor de genoemde maat en uitvoering.

Bij behang geven unit_pricing_measure en unit_pricing_base_measure de oppervlakte en m²-basis aan. Een voorbeeld van 1 m² kost een ander totaalbedrag dan een volledige wand. Een andere muurmaat vraagt de berekening in de studio. Gebruik deze catalogus niet als definitieve maatwerkofferte.

Verzending staat afzonderlijk bij de variant, met land, eurocenten en eventuele gratis grens. Controleer de actuele checkout voordat je een definitief aankoopbedrag noemt. Ontbrekende of veranderde aanbiedingen worden niet vervangen door een geschatte prijs.

Fouten en grenzen

Een toolfout heeft isError: true. PRODUCT_NOT_FOUND betekent dat de ID niet meer in de huidige openbare catalogus voorkomt. CATALOG_UNAVAILABLE betekent dat actuele gegevens niet beschikbaar zijn; probeer later opnieuw. Bij ongeldige invoer geeft de SDK een schemafout terug.

De tools antwoorden met tekst en structuredContent. Lees alleen de gedocumenteerde velden. Product- en variant-ID’s zijn stabiel; beschikbaarheid, prijzen en het aantal resultaten kunnen veranderen. Onbekende tools kunnen niet worden aangeroepen.

Deze release ondersteunt geen upload, ontwerpwijziging, previewgeneratie, klantgegevens of aankoop. Dit geldt ook voor fotoreliëf. Gebruik geen bedrijfsaccount, klanttoken of privé-URL als toolinvoer.