
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 toolsPublic 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_KEYsecretOptional API key for Pro/Enterprise tier access. Without a key, free tier (50 calls/day) is used.
SOMMELIERX_API_URLdefault: https://api.sommelierx.comAPI base URL (defaults to https://api.sommelierx.com).
SOMMELIERX_LANGUAGEdefault: enDefault 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
Details
- Repository
- github.com/rogertheunissenmerge-oss/mcp-server
- Package
@sommelierx/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active