rogertheunissenmerge-oss avatar

Mcp Server

rogertheunissenmerge-oss/mcp-server

Connects Claude or any MCP client to a sommelier-grade wine pairing API with seven tools spanning ingredient-to-wine matching, reverse lookup (wine to dishes), and multi-course group pairing. The free tier handles basic queries like "what pairs with salmon and asparagus" using deterministic scoring across 17 food dimensions and 19 wine dimensions. Pro tools extract ingredients from recipe URLs and find optimal wines for three-course dinners. Authentication works via API key with monthly call allowances or pay-per-call using x402 USDC payments on Base. Reach for this when you need programmatic access to wine recommendations that go beyond GPT's training data, with pricing from half a cent to three cents per call.

tools
7
auth
Secret needed
transport
STDIO
env vars
3
last updated
Apr 16, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

pair_wine_with_ingredientsFind wines for a list of ingredients (e.g. "salmon, lemon, dill").

Find wines for a list of ingredients (e.g. "salmon, lemon, dill").

No parameter schema in public metadata yet.

pair_wine_with_mealFind wines for a dish name (e.g. "risotto ai funghi").

Find wines for a dish name (e.g. "risotto ai funghi").

No parameter schema in public metadata yet.

find_meals_for_wineFind dishes that pair with a wine style (e.g. "Barolo").

Find dishes that pair with a wine style (e.g. "Barolo").

No parameter schema in public metadata yet.

search_ingredientsSearch the ingredient database.

Search the ingredient database.

No parameter schema in public metadata yet.

search_mealsSearch the meal database.

Search the meal database.

No parameter schema in public metadata yet.

pair_wine_with_recipe_urlExtract ingredients from a recipe URL and pair wines.

Extract ingredients from a recipe URL and pair wines.

No parameter schema in public metadata yet.

group_pairingFind the best wine across multiple dishes (e.g. 3-course dinner).

Find the best wine across multiple dishes (e.g. 3-course dinner).

No parameter schema in public metadata yet.

Sponsors

Configuration

SOMMELIERX_API_KEYsecret

Optional API key for Pro/Enterprise tier access. Without a key, free tier (50 calls/day) is used.

SOMMELIERX_API_URLdefault: https://api.sommelierx.com

API base URL (defaults to https://api.sommelierx.com).

SOMMELIERX_LANGUAGEdefault: en

Default language for responses: en, nl, fr, de, es, or it.

Readme

@sommelierx/mcp-server

Wine pairing intelligence for AI assistants. Connect Claude, Cursor, Windsurf, or any MCP-compatible client to a sommelier-grade pairing algorithm that matches wines to your ingredients, dishes, and recipes.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"]
    }
  }
}

That is it. Ask Claude "What wine goes with grilled salmon?" and it will use SommelierX to answer.

With a Pro API key

For recipe extraction, group pairing, and score breakdowns:

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"],
      "env": {
        "SOMMELIERX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor / Windsurf / Other MCP Clients

The same configuration works. Add the command and args to your client's MCP settings.

Available Tools


View the full README on GitHub

Details

Repository
github.com/rogertheunissenmerge-oss/mcp-server
Package
@sommelierx/mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active