MCP Server

Wine intelligence for
your AI assistant

The wine-ai MCP server connects FastCork to Claude Desktop, Cursor, Windsurf, and any MCP-compatible platform. Your AI can identify wines from photos, search for recommendations, and chat as a sommelier.

Get API Key View on npm

Installation

Choose your platform and add the configuration. Replace fc-your_key with your FastCork API key.

Claude Desktop
Claude Code
Cursor / Windsurf

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"
      }
    }
  }
}

Run in your terminal:

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

Add to your MCP settings:

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

Tools

analyze_wine_label
Analyze a wine label image and extract structured data: producer, vintage, region, grape varieties, tasting notes, food pairings, serving temperature, decanting time, and price. Pass a file path to any JPEG, PNG, or WebP image.
search_wines
Search for wines using natural language. Describe what you're looking for — grape, style, price range, food pairing, region, or occasion — and get ranked recommendations with full structured data.
sommelier_chat
Chat with an AI sommelier for wine recommendations, food pairings, tasting notes, and cellar advice. Supports multi-turn conversations via session ID.

Example

Once installed, just ask your AI assistant naturally:

"What wine pairs well with duck confit?"

"Analyze the wine label in ~/photos/bottle.jpg"

"Find me a bold red under $30 for a barbecue"

Your AI assistant will automatically call the right FastCork tool and return structured results.

Pricing

Each tool call costs $0.003. Start with $5 prepaid credit (~1,667 calls). Metered billing activates automatically after the credit is used.

Also available

Prefer to integrate directly? FastCork is a standard REST API — see the full API reference or check out the label recognition and sommelier chat guides.