Book wine experiences
from your agent
WineTourism.com runs a public Model Context Protocol (MCP) server. Any MCP-capable assistant or agent can search live listings, quote a price for a date and party size, and create a real booking. The guest completes payment on winetourism.com.
Connect
The server speaks streamable HTTP and needs no API key. Add the endpoint to your MCP client, or read the server card for the machine-readable description.
- MCP endpoint
POST https://mcp.winetourism.com/mcp- Server card
- https://mcp.winetourism.com/.well-known/mcp.json
This site's own /.well-known/mcp.json redirects to the server card, so a client that probes winetourism.com finds the same document. /.well-known/mcp.json
- Transport
- Streamable HTTP (POST), no authentication
Client configuration
For clients that take a JSON server list (Claude Desktop, Claude Code, Cursor and similar), one entry is enough:
{
"mcpServers": {
"winetourism": {
"type": "http",
"url": "https://mcp.winetourism.com/mcp"
}
}
}Tools
Seven tools. Five form the structured booking API; search and fetch are thin aliases in the shape ChatGPT connectors look for.
| Tool | What it does | Kind |
|---|---|---|
| search_experiences | Search live, bookable experiences by country, region, category, party size or price cap. Returns priced cards, each with a booking_mode telling you whether payment is immediate or follows host confirmation. | Read-only |
| get_experience | Full live details for one experience by the numeric id search returned, including whether it can be booked online. | Read-only |
| check_availability | Slots and prices for a date range and party size. Every slot carries a quote_token that pins the session, party size and price for 30 minutes. | Read-only |
| create_booking | Creates a real booking from a quote_token and the guest's name, email and phone. Returns a payment link (instant experiences) or the next step the guest must be told (request-only). Retries with the same quote and email are idempotent. | Creates a booking |
| get_booking_status | Current status of a booking by confirmation code and guest email, including whether it is paid and any live payment link. | Read-only |
| search | Free-text search returning opaque ids and public URLs, for ChatGPT-style connectors. Use search_experiences for filters and prices. | Read-only |
| fetch | Full text of one listing by an id from search. | Read-only |
Booking flow
A booking is four steps, in this order. The server's policies resource and the booking prompt walk an agent through the same sequence.
Find an experience
Call search_experiences with the guest's country, region or category and party size, then get_experience for the one they choose. Always show the guest the listing URL.
Quote a slot
Call check_availability for the dates and party size. Quote grand_total_minor, which includes the booking service fee, in the returned currency. Minor units: divide by 100 except for zero-decimal currencies.
Create the booking
Pass the chosen slot's quote_token unchanged to create_booking with the guest's name, email and phone. If the quote expired or no longer matches, fetch a fresh one and re-confirm the price.
Payment on winetourism.com
Instant experiences return a payment link the guest must open before it expires; the booking is not secured until they pay. Request-only experiences are confirmed by the host first, and the guest is emailed a payment link afterwards. Relay the returned next_step verbatim.
Resources and prompts
- winetourism://policies
- The authoritative summary of fees, the two payment flows, quote expiry, minor-unit handling and where cancellation terms live. Read it before quoting fees or cancellation terms.
- book_a_wine_experience
- A prompt that puts the journey in order for a model that has not booked here before.
Good to know
- Bookings are real. create_booking reserves a slot immediately; it is not a draft or a sandbox.
- The server never takes payment. Cards are entered only on winetourism.com's payment page.
- Requests are rate limited per IP, and bookings are capped per IP and per day across all callers. A THROTTLED result means nothing was attempted.
- The server identifies itself as winetourism; that name is stable and safe to key on.
- The server's source lives alongside this site in the wtplatform repository, under apps/wtmcp.
Policies your agent must relay
Questions or a broken integration?
Write to us and mention the tool name and the request id or confirmation code.
Contact us