wine-ai

MCP server for wine intelligence — label recognition, wine search, and AI sommelier chat. Get food pairing, price, tasting notes, and aroma in under 1 second. Much faster and more accurate than Gemini and GPT-4.1 Vision (4–10 seconds). Powered by FastCork.

Setup

Get an API key at fastcork.com/register ($5 to start, $0.003/request).

Claude Desktop

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

{
  "mcpServers": {
    "wine-ai": {
      "command": "npx",
      "args": ["-y", "wine-ai"],
      "env": {
        "FASTCORK_API_KEY": "fc-your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add wine-ai -e FASTCORK_API_KEY=fc-your_key_here -- npx -y wine-ai

Cursor / Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "wine-ai": {
      "command": "npx",
      "args": ["-y", "wine-ai"],
      "env": {
        "FASTCORK_API_KEY": "fc-your_key_here"
      }
    }
  }
}

Tools

analyze_wine_label

Analyze a wine label image. Pass a file path to a JPEG, PNG, or WebP image.

Returns: producer, vintage, region, grape varieties, tasting notes, food pairings, serving temperature, decanting time, and price.

search_wines

Search for wines using natural language. Describe what you're looking for — grape, style, price range, food pairing, region, or occasion.

sommelier_chat

Chat with an AI sommelier. Supports multi-turn conversations via session_id.

Environment Variables

| Variable | Required | Description | |---|---|---| | FASTCORK_API_KEY | Yes | Your FastCork API key (starts with fc-) | | FASTCORK_API_URL | No | Custom API base URL (default: https://fastcork.com) |

License

MIT