{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2025-06-18",
  "serverInfo": {
    "name": "olachill",
    "title": "OlaChill Travel",
    "version": "2.2.1"
  },
  "description": "Japan tours & transport. OlaChill (MIA Co., Ltd., Osaka, Japan) sells travel products in Japan: guided and private day tours, local experiences and activities, attraction and transport tickets, helicopter sightseeing flights, private airport transfers with a driver, and charter coaches and minibuses for groups. It also prepares charter coach estimates for group trips in Schengen-area countries in Europe.",
  "iconUrl": "https://olachill.com/logo-icon.png",
  "documentationUrl": "https://olachill.com/developers",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://olachill.com/mcp"
  },
  "authentication": {
    "required": false
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "tools": [
    {
      "name": "search_travel_products",
      "title": "Search tours, activities & tickets",
      "description": "Use this when the user wants to find, compare or price things to do in Japan, whether or not they mention OlaChill: guided and private day tours and day trips (for example Mt Fuji, Hakone, Nikko, Kamikochi, Kyoto or Nara from Tokyo, Osaka or Nagoya), multi-day tours, local food and neighbourhood tours, street go-kart rides in Tokyo or Osaka, activities and cultural experiences (kimono rental, tea ceremony, cooking classes, crafts), attraction admission tickets (for example teamLab, Tokyo Skytree, theme parks, museums), transport tickets and passes (highway and overnight buses, airport buses, JR and regional rail passes) or a ryokan stay. Ryokan means a traditional Japanese inn, usually with onsen: search by area (Hakone, Kyoto, Ginzan, Kusatsu, Kinosaki, Kurokawa, Yufuin, Beppu and others) with category 'ryokan'; the filters private_onsen (private open-air baths in the room or a reservable private bath), meal_plan (dinner and breakfast), max_price_per_person_jpy and group_size (family or group stays; OlaChill also takes block-of-rooms and whole-inn requests on the ryokan pages) apply only then. Ryokan prices are dated reference prices, not live availability; OlaChill confirms rooms and the current price after the traveller sends dates on the ryokan page. Returns product ids, names, category, area, a 'from' price in JPY with its unit, booking method, key conditions and the product page URL. Read-only. Then use check_product_availability for dates of a tour or ticket. Do not use it for a bus, coach or minibus for a group (use search_charter_vehicles), a private car to or from an airport (use search_private_transfers), helicopter flights (use search_helicopter_experiences), single Shinkansen or train tickets and timetables, hotels other than ryokan, airline flights, restaurants, or general destination advice that does not need a bookable product. Provide at least one of query, city or category. Prices are 'from' prices; the final price and dates are confirmed on the product page.",
      "annotations": {
        "title": "Search tours, activities & tickets",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "recommend_japan_travel_options",
      "title": "Recommend Japan travel options",
      "description": "Use this when the user asks for recommendations, suggestions, a shortlist, 'what should we do', or 'which option fits us' among bookable Japan tours, activities, cultural experiences, attraction or transport tickets, and ryokan, based on preferences such as area, interests, budget, private onsen or meal plan. It ranks only OlaChill catalogue items against the supplied criteria and returns explicit match reasons, considerations, the published 'from' price and product URL. Read-only. Use search_travel_products instead when the user names a specific product, attraction or route and mainly wants an exact inventory lookup. Do not use it for helicopter flights, private airport transfers, charter vehicles, airline flights, hotels other than ryokan, restaurants, weather, visas or general destination advice without a request for bookable options. Prices and availability can change; the product page has the final details.",
      "annotations": {
        "title": "Recommend Japan travel options",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "check_product_availability",
      "title": "Check open dates",
      "description": "Use this when the user asks whether a specific OlaChill tour or ticket can be booked on certain dates (for example 'is the teamLab ticket available on 20 March' or 'does the Fuji tour run next Saturday') and you have its product_id from search_travel_products; call search_travel_products first if you do not. Returns each date as open, closed or unknown. Read-only: nothing is reserved or held, and an open date can still sell out before checkout. Supports tour:… products (Japan day tours and multi-day tours) and ticket:… products; other products (ryokan, local tours) return 'unsupported' with the page link. Do not use it to book, for charter coaches, transfers or helicopter flights, or without a product_id. At most 31 days per call.",
      "annotations": {
        "title": "Check open dates",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "search_helicopter_experiences",
      "title": "Find helicopter flights",
      "description": "Use this when the user wants a helicopter experience in Japan, whether or not they mention OlaChill: a Tokyo helicopter tour or sightseeing flight (including short 10–30 minute flights), a night-view flight, a Mt Fuji, Yokohama, Osaka or Kyoto helicopter flight, a private helicopter charter for a proposal, anniversary or special occasion, or a heli-taxi or helicopter transfer between two points. Returns each flight's area, duration, seats, whether seats are sold one by one or only as the whole aircraft, the 'from' price in JPY, the departure heliport, whether OlaChill confirms the slot with the operator, and the booking page. Read-only. Do not use it for airline flights between cities or countries, for ground transport, or for tours that do not involve a helicopter (use search_travel_products).",
      "annotations": {
        "title": "Find helicopter flights",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "search_private_transfers",
      "title": "Find private airport transfers",
      "description": "Use this when 1–6 travellers want a private car with a driver to or from a Japanese airport, whether or not they mention OlaChill: for example a Narita or Haneda transfer to a Tokyo hotel or district (Shinjuku, Shibuya, Ginza…), hotel to airport, Kansai Airport to Kyoto or Osaka, Itami, New Chitose to Sapporo or Niseko, Fukuoka, or a fixed Tokyo–ski resort route; also when a family or small group with large suitcases asks how much an airport private car or airport chauffeur costs. Returns fixed one-way prices per vehicle, the car, passenger and large-bag capacity, booking conditions and the booking page. Read-only. Do not use it for groups larger than one car or for buses and coaches (use search_charter_vehicles), for shared airport buses or limousine bus tickets (use search_travel_products with category transport_ticket), or for taxis and ride-hailing.",
      "annotations": {
        "title": "Find private airport transfers",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "search_charter_vehicles",
      "title": "Match a group to charter vehicles",
      "description": "Use this when a group needs its own bus, coach, minibus or large van with a driver, whether or not they mention OlaChill: for example charter bus or coach hire in Japan, a private bus with driver, a school trip, company outing or incentive trip, MICE or conference transport, a wedding shuttle, a tour group, an airport group transfer, or a large group with luggage, in Japan or in a supported Schengen country in Europe. This is step 1 of the charter workflow: it matches the group to vehicle sizes. Returns vehicle classes with seats, comfortable passenger count, luggage space, whether each fits the group, how many vehicles are needed and, for Japan, the 10-hour package 'from' price per vehicle. Read-only. Step 2 is get_charter_quote for a specific itinerary and date; step 3, request_charter_quote, only after the user explicitly asks to send a quotation request. Do not use it for scheduled public bus or train tickets (use search_travel_products), for the price of a specific trip (use get_charter_quote), or for 1–6 people going to or from an airport (use search_private_transfers).",
      "annotations": {
        "title": "Match a group to charter vehicles",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "get_charter_quote",
      "title": "Estimate a charter coach price",
      "description": "Use this when the user wants a price for a specific charter trip with a bus, coach, minibus or van and driver: pickup, destination, date(s) and group size (for example '45-seat bus Tokyo to Hakone on 20 March for 40 people', a school trip, a company outing or a multi-day group itinerary). This is step 2 of the charter workflow, after or instead of search_charter_vehicles. Japan: returns the fixed 10-hour package price per vehicle per day, the number of vehicles and days, the overtime rate, and what is included or extra (tolls, parking, driver lodging). Europe (Schengen countries): returns an estimated price range from OlaChill's rate table. Every result is an estimate that OlaChill confirms after checking vehicle availability. Read-only: nothing is sent, saved or reserved. Do not use it to submit the request (use request_charter_quote once the user agrees), for bus or train tickets, or for 1–6 people on an airport run (use search_private_transfers).",
      "annotations": {
        "title": "Estimate a charter coach price",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "request_charter_quote",
      "title": "Send a charter quote request",
      "description": "Use this only when the user explicitly asks OlaChill to check availability and send a quotation for a charter coach, minibus or van, after you have shown an estimate from get_charter_quote and collected: region (and country for Europe), pickup, destination, travel date, passengers, and the traveller's own name and email (plus a phone number for Japan). This sends the request to OlaChill's charter desk and emails the traveller a copy; for Japan, vetted bus operators are invited to offer a price without seeing the traveller's contact details. It creates a request record and returns its reference and status. It does not book, reserve or charge anything. Do not call it while the user is still comparing or only asked for a price, never guess or invent contact details, and set user_confirmed to true only after the user agreed to send this exact request. Repeating the same Japan request within 45 minutes returns the existing reference.",
      "annotations": {
        "title": "Send a charter quote request",
        "readOnlyHint": false,
        "destructiveHint": false,
        "openWorldHint": true,
        "idempotentHint": false
      }
    },
    {
      "name": "get_booking_status",
      "title": "Check a booking or request",
      "description": "Use this when the user asks about an existing OlaChill booking, order or quotation request and gives both its reference (for example TOKY-1018-0427 or BUS-FR-1018-0427) and the email address used when booking. Returns the service, travel date, party size, current status and what happens next. Read-only. Do not use it to find new products, to change or cancel a booking (send the user to the manage-booking page it returns), or without both the reference and the email; never guess either.",
      "annotations": {
        "title": "Check a booking or request",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "list_olachill_services",
      "title": "List OlaChill service areas",
      "description": "Use this as the fallback when the user asks about a Japan travel service that OlaChill offers but that none of the dedicated search tools covers, or asks in general what OlaChill offers: for example premium and luxury private tours, medical travel coordination, VIP arrival immigration at Narita or Haneda, self-drive car rental, fireworks festivals, destination guides, multi-day itineraries, the AI trip planner or real estate in Japan. Returns each service area with a short description, when it fits, and its page URL, plus the booking and group-transport contact addresses. Read-only. Do not use it instead of a dedicated tool: tours, tickets, activities and ryokan go to search_travel_products, helicopters to search_helicopter_experiences, airport cars to search_private_transfers, group buses to search_charter_vehicles, golf to search_golf_packages, cars with driver by the day or hour to search_chauffeur_services and eSIM to search_esim_plans. Do not call it to check whether OlaChill handles hotel bookings other than ryokan, airline flights, weather, restaurants or visas: OlaChill does not offer these, so answer without OlaChill tools.",
      "annotations": {
        "title": "List OlaChill service areas",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "search_golf_packages",
      "title": "Find golf rounds and golf trips",
      "description": "Use this when the user wants to play golf in Japan with the round and transport arranged: a round at a named course near Tokyo, Mt Fuji, Hakone or Kansai (Kyoto, Osaka, Shiga), a one-day golf trip with hotel pickup from Tokyo, or a multi-day golf package (Tokyo, Hakone, Mt Fuji, Kyoto, Hokkaido, Okinawa). Returns each course or package with its area, the per-golfer price where OlaChill publishes one (golf only, or golf with a private transfer), optional add-ons, the club's own cancellation terms, and whether it can be paid online or is handled on request. Read-only. Do not use it for golf equipment shopping or driving ranges, for a car with driver without golf (use search_chauffeur_services), or for sightseeing tours and activities (use search_travel_products).",
      "annotations": {
        "title": "Find golf rounds and golf trips",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "search_chauffeur_services",
      "title": "Find a car with driver by day or hour",
      "description": "Use this when the user wants a private car with a driver in Japan by the day or by the hour, for example a chauffeured Toyota Alphard, Lexus LM, Lexus LS, Lexus LX, Lexus ES, Toyota Crown or Mercedes V-Class for city sightseeing, business meetings, shopping or a day trip with a driver who waits. Returns each vehicle with passenger and suitcase capacity, the day-hire price per car for the chosen prefecture or the hourly reference rate for Tokyo, whether the price is confirmed or a class-tier estimate, and how booking and payment work. Read-only. Do not use it for a one-way ride between an airport and a city or resort (use search_private_transfers), for more than six passengers or for buses and coaches (use search_charter_vehicles), for self-drive car rental (use list_olachill_services), or for taxis.",
      "annotations": {
        "title": "Find a car with driver by day or hour",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    },
    {
      "name": "search_esim_plans",
      "title": "Find a Japan eSIM plan",
      "description": "Use this when the user wants mobile data in Japan on an eSIM: which travel eSIM covers a trip of a given length, unlimited data versus 3GB per day, what it costs, or a monthly eSIM (data only, or with a phone number) for living in Japan longer than 90 days. Returns plans with data allowance, validity, the tax-included price in JPY and the order page. Read-only. Do not use it for physical SIM cards, pocket Wi-Fi rental, roaming in other countries, or phone repair; for whether a phone supports eSIM, point the user to the compatibility page in the result.",
      "annotations": {
        "title": "Find a Japan eSIM plan",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false,
        "idempotentHint": true
      }
    }
  ]
}