@thewinetrip/mcp-server

MCP server for TheWineTrip — exposes wine region data and trip planning tools to Claude Desktop and any MCP-compatible AI client.

Tools

| Tool | Description | |------|-------------| | list_regions | List all available wine regions on TheWineTrip | | get_region | Get detailed guide data for a region (climate, wine styles, budget, best months, wineries) | | get_wineries | Get GPS-mapped wineries for a region, with affiliate booking URLs | | generate_itinerary | Generate a personalised day-by-day wine trip itinerary for a region |

Install — Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "thewinetrip": {
      "command": "npx",
      "args": ["-y", "@thewinetrip/mcp-server"],
      "env": {
        "TWT_API_BASE": "https://thewinetrip.com"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

After saving, restart Claude Desktop. You should see the TheWineTrip tools available in the tools panel.

npx Usage

Run the server directly without installing:

npx -y @thewinetrip/mcp-server

Or with a custom API base (e.g. local dev):

TWT_API_BASE=http://localhost:3006 npx -y @thewinetrip/mcp-server

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | TWT_API_BASE | https://thewinetrip.com | Base URL for the TheWineTrip REST API |

Requirements

• Node.js 18 or later (uses native fetch)
• No additional dependencies

Tool Reference

list_regions

Returns all available wine region slugs.

No input required.

get_region

Returns detailed guide data for a wine region.

region  string  required  Region slug (e.g. "napa", "bordeaux", "tuscany", "douro", "mendoza")

get_wineries

Returns GPS-mapped wineries for a region.

region  string  required  Region slug
q       string  optional  Winery name search query
limit   number  optional  Max results (default 50, max 200)

generate_itinerary

Generates a day-by-day personalised wine trip itinerary.

region     string    required  Region slug
days       number    required  Trip length in days (1-14)
style      string    required  "romantic" | "serious" | "budget" | "luxury"
interests  string[]  optional  e.g. ["natural wine", "cycling", "Michelin dining"]

License

MIT