NEVINI Wines

Search the wines of NEVINI, a Dutch wine importer, and build Shopify carts with a checkout link.

View on nevini.wine

Hosted MCP Server

npx add-mcp 'https://nevini.wine/api/mcp/'

Installs into Claude Code, Codex, Cursor and more

Documentation

Endpoint

Voeg deze URL toe als externe MCP-server. Gebruik hem precies zo, met de slash aan het eind.

https://nevini.wine/api/mcp/
  • Transport: Streamable HTTP
  • Geen inlog, account of API-sleutel nodig
  • Antwoorden in het Nederlands of Engels (language: "nl" of "en")

Open je de URL in een browser, dan zie je een korte beschrijving van de server: https://nevini.wine/api/mcp/

Wat een agent ermee kan

  • Wijnen zoeken en filteren op type, land, regio, druif, prijs, voorraad en bijpassend gerecht.
  • Details van een wijn ophalen: smaaknoten, beschrijving, flesformaten en actuele prijzen uit Shopify.
  • Winkelinformatie lezen: adres, contact, verzending, ophalen en retour.
  • Een Shopify-winkelwagen samenstellen en een checkoutlink op shop.nevini.wine teruggeven.

Voorbeeldvragen

Vragen die een agent met deze server kan beantwoorden, met de tools die hij daarvoor gebruikt:

Zoek een Italiaanse rode wijn onder de 30 euro die in Nederland bezorgd kan worden.

search_wines (type red, country IT, max_price_eur 30) en get_store_info

Welke witte wijn past bij vis of zeevruchten?

search_wines (type white, food seafood), daarna get_wine voor smaaknoten en beschrijving

Zoek een champagne onder de 50 euro en zet een winkelwagen klaar.

search_wines (type champagne, max_price_eur 50) en create_cart

Welke amarone heeft NEVINI, van goedkoop naar duur?

search_wines (query amarone, sort price_asc)

Laat wijnen uit Moldavië zien.

search_wines (country Moldova)

Bezorgen jullie in België, en vanaf welk bedrag is de verzending gratis?

get_store_info

Doe er nog twee flessen bij en geef me de checkoutlink.

add_to_cart of update_cart, daarna get_cart

Verbinden

Elke client die externe MCP-servers via HTTP ondersteunt, kan verbinden. Voorbeelden:

Claude Code

claude mcp add --transport http nevini https://nevini.wine/api/mcp/

claude.ai en Claude Desktop

Ga naar Customize > Connectors, kies "+ Add" en daarna "Add custom connector". Vul een naam en de URL hierboven in en kies Continue. Claude herkent dat er geen inlog nodig is ("No sign-in"); kies Add en daarna Connect. In Team- en Enterprise-organisaties voegt een eigenaar de connector toe onder Organization settings > Connectors.

ChatGPT

Open in ChatGPT op het web de pagina Plugins (chatgpt.com/plugins), kies de plusknop en daarna "Add custom MCP server". Vul een naam in en zet de URL hierboven bij Connection als Server URL. Kies "No authentication", bevestig met "I understand and want to continue" en kies "Create as a plugin". Installeer de plugin en typ @ in een gesprek om hem te gebruiken. Of je eigen MCP-servers kunt toevoegen, hangt af van je account en de instellingen van je werkruimte.

Cursor (~/.cursor/mcp.json of.cursor/mcp.json)

{
  "mcpServers": {
    "nevini": { "url": "https://nevini.wine/api/mcp/" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "nevini": { "type": "http", "url": "https://nevini.wine/api/mcp/" }
  }
}

Tools

search_wines

Wijnen zoeken en filteren.

get_wine

Details van één wijn, met varianten en prijzen.

get_catalog_overview

Overzicht van types, landen, categorieën, druiven en topselectie.

get_store_info

Bedrijfsgegevens, verzending, ophalen, retour en leeftijdseis.

create_cart

Nieuwe winkelwagen met regels, geeft een checkoutlink.

add_to_cart

Regels toevoegen aan een bestaande winkelwagen.

update_cart

Aantallen wijzigen of regels verwijderen.

get_cart

Huidige inhoud en checkoutlink van een winkelwagen.

Bestellen en leeftijd

  1. De agent zoekt wijnen en stemt de keuze af met de gebruiker.
  2. Voor create_cart bevestigt de gebruiker dat hij of zij 18 jaar of ouder is.
  3. De agent geeft de checkoutlink op shop.nevini.wine aan de gebruiker.
  4. De klant opent de checkout en rondt daar de bestelling en de betaling zelf af.

Via de MCP-server wordt geen bestelling geplaatst en niet betaald.

NEVINI verkoopt alcohol. Koper en ontvanger moeten 18 jaar of ouder zijn (Alcoholwet); bestellingen voor iemand onder de 18 zijn niet toegestaan. De bestelling wordt pas geplaatst als de klant zelf de checkout opent en de bestelling afrondt. Bij de bezorging kan de leeftijd van de ontvanger worden gecontroleerd; houd een geldig identiteitsbewijs bij de hand.

Skill voor AI-agenten

De Agent Skill order-nevini-wine beschrijft stap voor stap hoe een agent via deze MCP-server wijn voor zijn gebruiker bestelt. Lees hem hier:

https://nevini.wine/.well-known/agent-skills/order-nevini-wine/SKILL.md

Of installeer hem met:

npx skills add https://nevini.wine

Machine-leesbare bronnen

Voor agents en crawlers die de server automatisch willen vinden:

De server staat in het officiële MCP Registry als wine.nevini/shop: https://registry.modelcontextprotocol.io/v0.1/servers/wine.nevini%2Fshop/versions/latest

Vragen

Vragen over de MCP-server? Mail naar info@nevini.wine.