Loading...
Loading...
Real wine travel data for AI agents and apps. Use the MCP server to ground Claude's wine trip answers in actual winery records — or query the REST API directly to build your own experience.
Connect Claude Desktop to 45,000+ GPS-mapped wineries and real regional data. Claude stops guessing wine trip details and starts querying our database — real winery names, real harvest timing, real accommodation tiers. Setup is one command and one config line.
Anonymous requests are capped at 20/day per IP. A free key unlocks 100/day. Pro unlocks 10,000/day.
Already have a key? Check your usage →
Authorization: Bearer twt_live_…Every response carries quota headers. When the limit is reached, you'll get a 429 with the same headers and a reset epoch.
/api/v1/regions/{slug}Returns region metadata, wine guide data, and up to 50 wineries with affiliate URLs.
/api/v1/wineries?region={slug}Search GPS-mapped wineries for a region. Optional q (name search) and limit (max 200) params.
/api/v1/plan?region={slug}&days={n}&style={style}Generate a structured day-by-day itinerary via query params. Identical response shape to POST. Styles: romantic, serious, budget, luxury. Days default to 3 if omitted.
/api/v1/planGenerate a structured day-by-day itinerary via JSON body. Returns JSON suitable for AI agents, apps, and direct rendering.
/api/save-tripSave a trip itinerary. Returns an ID that can be used to share the trip via /trip/{id}.
{
"id": "winery_napa_001",
"name": "Opus One Winery",
"region": "napa-valley",
"area": "Napa Valley",
"type": "Estate Winery",
"website": "https://opusonewinery.com",
"latitude": 38.4285,
"longitude": -122.408,
"affiliate_url": "https://thewinetrip.com/go/viator?dest=napa"
}