# NEVINI Wines MCP server

Public MCP server of NEVINI, a wine importer in Maastricht (the Netherlands): search the wine catalog, read store information and build Shopify carts that the customer checks out on shop.nevini.wine.

Nederlands: Publieke MCP-server van NEVINI, wijnimporteur in Maastricht: zoek wijnen, lees winkelinformatie en maak een Shopify-winkelwagen; de klant rondt de bestelling en betaling zelf af in de checkout.

- Endpoint: https://nevini.wine/api/mcp/
- Transport: Streamable HTTP; JSON-RPC 2.0 over HTTP POST (stateless; JSON responses, no session needed)
- Authentication: none

## Tools

- `search_wines` (Search wines): Searches the NEVINI wine catalog by free text and filters (type, country, region, grape, verified price range, availability).
- `get_wine` (Get wine details): Returns one wine by slug, numeric id, name or wine URL: description, grapes, taste notes, serving temperature, rating, every bottle size with its variant_id, live price and availability, and related wines.
- `get_catalog_overview` (Catalog overview): Returns an overview of the NEVINI range: wine counts per type, country and category page, the most common grapes, the top selection and the verified price range.
- `get_store_info` (Store information): Returns NEVINI store facts: company and contact details, contact availability, pickup in Maastricht, shipping rates, countries and delivery times, returns, age policy, payment, hospitality services, policy URLs and how ordering through this server works.
- `create_cart` (Create cart): Creates a new Shopify cart with wine variants (variant_id from search_wines or get_wine) and returns cart_id, the items with live prices, the subtotal and checkout_url.
- `add_to_cart` (Add to cart): Adds wine variants to an existing cart; quantities add up with lines already in the cart.
- `update_cart` (Update cart): Sets the quantity of existing cart lines by line_id; quantity 0 removes a line.
- `get_cart` (Get cart): Returns the current lines, live prices, subtotal and checkout_url of a cart.

## Ordering

The cart tools return checkout_url. No order is placed and no payment is taken through this server; the customer pays in checkout on shop.nevini.wine. NEVINI sells alcohol. The buyer and the recipient must be 18 or older (Dutch Alcohol Act); orders for anyone under 18 are not allowed. The order is only placed once the customer opens the checkout and completes the order. The recipient's age may be checked on delivery; have a valid ID ready.

## Connect

- Claude Code: `claude mcp add --transport http nevini https://nevini.wine/api/mcp/`
- ChatGPT, claude.ai, Cursor, VS Code and other MCP clients: add a custom (remote) MCP server or connector with the URL https://nevini.wine/api/mcp/ and no authentication.

## Links

- Documentation: https://nevini.wine/mcp/
- MCP discovery file: https://nevini.wine/.well-known/mcp.json
- MCP Server Card: https://nevini.wine/.well-known/mcp/server-card.json
- ARD manifest: https://nevini.wine/.well-known/ard.json
- Official MCP Registry entry (wine.nevini/shop): https://registry.modelcontextprotocol.io/v0.1/servers/wine.nevini%2Fshop/versions/latest
- Agent Skills index: https://nevini.wine/.well-known/agent-skills/index.json
- agents.md: https://nevini.wine/agents.md
- llms.txt: https://nevini.wine/llms.txt
- NEVINI website: https://nevini.wine/