Rogertheunissenmerge Oss

io.github.rogertheunissenmerge-ossPublished by GitHub account rogertheunissenmerge-ossv1.1.2Updated Oct 27, 2026

Wine pairing intelligence with 7 tools. Deterministic scoring, sommelier-calibrated.

VerifiedSTDIODesktop onlyLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

SommelierX wine pairing server that lets an assistant match wines to ingredients, dishes, recipes and multi-course menus.

What you can do
  • Pair wines with a list of ingredients or with a named dish
  • Find dishes that go with a given wine style
  • Search the ingredient and meal databases
  • Extract ingredients from a recipe URL and pair wines (Pro)
  • Find one wine that works across several dishes for a multi-course meal (Pro)
When to use it
Useful when you want an assistant to answer food-and-wine questions: what to drink with a dish, what to cook for a bottle you already own, or a single wine for a dinner party menu.
Requirements
Runs locally via npx, so Node.js 18 or newer is needed. An optional SOMMELIERX_API_KEY unlocks Pro features; without it the free tier allows 50 calls per day. Optional SOMMELIERX_API_URL and SOMMELIERX_LANGUAGE settings. Network access to the SommelierX API.
Before you install
Requests go to a third-party API. Without an API key, the server can return a 402 Payment Required response and x402-compatible agents may pay per call in USDC on the Base network, which spends real money from a wallet. A Pro subscription is billed monthly. The API key is a secret and should be kept out of shared configs.

Installation

In SourceWeft

  1. Open Rogertheunissenmerge Oss in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

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:

json
{  "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

ToolWhat it doesTier
pair_wine_with_ingredientsFind wines for a list of ingredients (e.g. "salmon, lemon, dill")Free
pair_wine_with_mealFind wines for a dish name (e.g. "risotto ai funghi")Free
find_meals_for_wineFind dishes that pair with a wine style (e.g. "Barolo")Free
search_ingredientsSearch the ingredient databaseFree
search_mealsSearch the meal databaseFree
pair_wine_with_recipe_urlExtract ingredients from a recipe URL and pair winesPro
group_pairingFind the best wine across multiple dishes (e.g. 3-course dinner)Pro

Authentication

SommelierX supports two authentication methods. You can use either one -- no need to configure both.

Option 1: API Key (subscription)

Set the SOMMELIERX_API_KEY environment variable in your MCP client config. The key format is sk_live_.... You get a monthly call allowance based on your tier (Free / Pro / Enterprise).

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

Get your API key at api.sommelierx.com.

Option 2: x402 Payment (pay per call)

No API key needed. Your AI agent pays per call using USDC on the Base network via the Coinbase x402 protocol. When a request lacks an API key, the server returns a 402 Payment Required response with a payment payload. x402-compatible agents handle this automatically.

This is ideal for:

  • AI agents that manage their own wallet
  • Pay-as-you-go usage without a subscription
  • Agent-to-agent commerce (no human in the loop)

Pricing (per call)

ToolPriceTier
pair_wine_with_meal$0.01Free
find_meals_for_wine$0.01Free
search_ingredients$0.005Free
search_meals$0.005Free
pair_wine_with_ingredients$0.02Pro
pair_wine_with_recipe_url$0.02Pro
group_pairing$0.03Pro

With an API key, calls are deducted from your tier allowance. With x402, each call is charged at the listed price.

Example Conversations

Basic pairing:

"What wine pairs well with salmon, asparagus, and hollandaise sauce?"

Reverse pairing:

"I have a bottle of Barolo. What should I cook?"

Recipe URL:

"What wine goes with this recipe? https://www.allrecipes.com/recipe/..."

Dinner party:

"I'm planning a 3-course dinner: Caesar salad, rack of lamb, and chocolate mousse. What single wine works for all courses?"

How It Works

  1. You ask your AI assistant a wine question
  2. The assistant calls the appropriate SommelierX tool
  3. The MCP server translates your input into structured API calls
  4. SommelierX's pairing algorithm (17 food DNA dimensions x 19 wine DNA dimensions) calculates matches
  5. You get scored wine recommendations based on real sommelier expertise

Ingredient Resolution

When you use pair_wine_with_ingredients, the server automatically resolves natural language ingredient names to database entries. The AI assistant does not need to know database IDs -- it passes ingredient names directly.

Configuration

Environment VariableRequiredDefaultDescription
SOMMELIERX_API_KEYNo--API key for Pro/Enterprise access. Without a key, free tier (50 calls/day).
SOMMELIERX_API_URLNohttps://api.sommelierx.comAPI base URL.
SOMMELIERX_LANGUAGENoenDefault language for results (en, nl, fr, de, es, it).

API Tiers

TierDaily LimitPer-Minute LimitFeatures
Free50 calls2/minBasic pairing, search, ingredient/meal lookup
Pro ($49/mo)500 calls20/min+ Recipe URL extraction, group pairing, score breakdowns
Enterprise10,000 calls100/min+ Custom limits, SLA

Get your API key at api.sommelierx.com

API Documentation

Full API documentation is available at docs.sommelierx.com.

The OpenAPI specification is served at https://api.sommelierx.com/api/v1/openapi.json.

Development

bash
npm installnpm run buildnpm run dev       # development mode with hot reloadnpm run typecheck # type checking without emit

Requirements

  • Node.js >= 18.0.0

License

MIT

Source: README.md at commit 717c24f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts