Klook API and MCP server

• POST

  search_activities

  Tours, tickets and experiences by keyword or destination, with price, rating and cancellation type.

  read

  Returns activities that match a keyword or destination, in the order set by sort. A date keeps only activities available that day. Each item has the lowest price, rating and review count, and the cancellation type: free, conditional or none. Use get_activity for packages and details.

  POST /api/v1/klook/search_activities

  Input

  Input: search_activities

  Parameter	Type	Description
  query required	string	Keyword or destination, e.g. "Mount Fuji day tour" or "Bangkok".
  date	date	Only activities available on this date.
  sort	enum	popular, price_low, price_high or rating. Default: popular.
  currency	string	ISO 4217 code, e.g. USD. Default: your account currency.
  limit	integer	1 to 50. Default: 20.

  Example response

  {
    "activities": [
      {
        "activity_id": "41528",
        "title": "Mount Fuji One Day Tour from Tokyo",
        "city": "Tokyo",
        "price_from": {
          "amount": 93.2,
          "currency": "USD"
        },
        "rating": 4.7,
        "reviews": 3120,
        "cancellation": "free"
      },
      {
        "activity_id": "30977",
        "title": "Mt. Fuji and Hakone Day Trip with Lake Cruise",
        "city": "Tokyo",
        "price_from": {
          "amount": 98.5,
          "currency": "USD"
        },
        "rating": 4.6,
        "reviews": 1844,
        "cancellation": "free"
      },
      {
        "activity_id": "52204",
        "title": "Private Mount Fuji Tour with English Driver",
        "city": "Tokyo",
        "price_from": {
          "amount": 112,
          "currency": "USD"
        },
        "rating": 4.8,
        "reviews": 402,
        "cancellation": "none"
      }
    ]
  }

• POST

  get_activity

  Packages with prices, what is included, meeting point and cancellation policy of one activity.

  read

  Returns one activity with its packages, each with its own package_id and lowest price. It also returns what is included, the meeting point and the cancellation policy shown on the activity page. Use package_id with check_availability and book_activity.

  POST /api/v1/klook/get_activity

  Input

  Input: get_activity

  Parameter	Type	Description
  activity_id required	string	Activity ID from search_activities.

  Example response

  {
    "activity_id": "41528",
    "title": "Mount Fuji One Day Tour from Tokyo",
    "packages": [
      {
        "package_id": "98731",
        "name": "Departure from Shinjuku, English guide",
        "price_from": {
          "adult": 93.2,
          "child": 80
        },
        "currency": "USD"
      },
      {
        "package_id": "98740",
        "name": "Departure from Tokyo Station, English guide",
        "price_from": {
          "adult": 96.5,
          "child": 83
        },
        "currency": "USD"
      }
    ],
    "includes": [
      "Round-trip bus",
      "English-speaking guide",
      "Lunch"
    ],
    "meeting_point": "Shinjuku Station West Exit",
    "cancellation": {
      "type": "free",
      "policy": "Free cancellation up to 24 hours before the start time"
    }
  }

• POST

  check_availability

  Open dates and time slots for a package, with the price per unit (adult, child).

  read

  Returns the open dates and time slots of one package in a date range, with the price per unit type. Dates with no slots are left out. Run it before book_activity or amend_booking so you only ask for a slot that exists.

  POST /api/v1/klook/check_availability

  Input

  Input: check_availability

  Parameter	Type	Description
  activity_id required	string	Activity ID from search_activities.
  package_id	string	Package from get_activity. Default: all packages.
  from required	date	First date to check.
  to	date	Last date to check. Default: same as from.

  Example response

  {
    "activity_id": "41528",
    "package_id": "98731",
    "availability": [
      {
        "date": "2026-11-14",
        "slots": [
          "08:00",
          "09:30"
        ],
        "price": {
          "adult": 93.2,
          "child": 80
        },
        "currency": "USD"
      },
      {
        "date": "2026-11-15",
        "slots": [
          "08:00"
        ],
        "price": {
          "adult": 93.2,
          "child": 80
        },
        "currency": "USD"
      }
    ]
  }

• POST

  list_activity_reviews

  Traveler reviews of an activity with rating, date and text.

  read

  Returns reviews of one activity, newest first by default, each with the rating, date and text. Set sort to rating to see the best rated first. Use it to check what travelers say before you book.

  POST /api/v1/klook/list_activity_reviews

  Input

  Input: list_activity_reviews

  Parameter	Type	Description
  activity_id required	string	Activity ID from search_activities.
  sort	enum	recent or rating. Default: recent.
  limit	integer	1 to 50. Default: 20.

  Example response

  {
    "activity_id": "41528",
    "reviews": [
      {
        "rating": 5,
        "date": "2026-10-02",
        "text": "Clear views of Fuji and a guide who kept to the schedule."
      },
      {
        "rating": 4,
        "date": "2026-09-28",
        "text": "Long day, but the lunch stop was good."
      }
    ],
    "next_cursor": null
  }

• POST

  list_bookings

  Bookings on your account with Booking Reference ID, activity, date and status.

  read

  Returns the bookings shown on the Bookings page of your account, with the Booking Reference ID, activity, participation date and status. Filter by upcoming, completed or cancelled. Pass booking_ref to get_booking, amend_booking or cancel_booking.

  POST /api/v1/klook/list_bookings

  Input

  Input: list_bookings

  Parameter	Type	Description
  status	enum	upcoming, completed, cancelled or all. Default: upcoming.
  limit	integer	1 to 100. Default: 20.

  Example response

  {
    "bookings": [
      {
        "booking_ref": "KPR834512",
        "activity": "Mount Fuji One Day Tour from Tokyo",
        "date": "2026-11-14",
        "status": "upcoming"
      },
      {
        "booking_ref": "NJT204518",
        "activity": "Nami Island and Petite France Day Tour from Seoul",
        "date": "2026-11-21",
        "status": "upcoming"
      },
      {
        "booking_ref": "BKK771903",
        "activity": "Bangkok Street Food Evening Tour",
        "date": "2026-12-02",
        "status": "upcoming"
      }
    ]
  }

• POST

  get_booking

  One booking with participants, cancellation policy, amend option and voucher link.

  read

  Returns one booking with its date, time, participants and voucher link. The cancellation policy says whether the booking is free to cancel, conditional or not cancellable, and whether Amend booking is available. Check it before amend_booking or cancel_booking.

  POST /api/v1/klook/get_booking

  Input

  Input: get_booking

  Parameter	Type	Description
  booking_ref required	string	Booking Reference ID from list_bookings, e.g. ABC123456.

  Example response

  {
    "booking_ref": "BKK771903",
    "activity": "Bangkok Street Food Evening Tour",
    "date": "2026-12-02",
    "time": "17:30",
    "status": "upcoming",
    "units": {
      "adult": 2
    },
    "total": {
      "amount": 64,
      "currency": "USD"
    },
    "cancellation": {
      "type": "free",
      "policy": "Free cancellation up to 24 hours before the start time"
    },
    "can_amend": true,
    "voucher_url": "https://www.klook.com/en-US/bookings/"
  }

• POST

  get_klookcash_balance

  KlookCash on your account with the expiry date of each part.

  read

  Returns your KlookCash balance and the entries it is made of, each with its expiry date, like the Klookcash page in your profile. Klook lets you use KlookCash only with at least 10 KlookCash, which usable shows. It takes no parameters.

  POST /api/v1/klook/get_klookcash_balance

  Input

  No parameters.

  Example response

  {
    "klookcash": 1850,
    "usable": true,
    "entries": [
      {
        "amount": 300,
        "expires_on": "2026-11-30"
      },
      {
        "amount": 1550,
        "expires_on": "2027-06-12"
      }
    ]
  }

• POST

  book_activity

  Book a package of an activity for a date. You see the total before anything is paid.

  asks first write

  Books one package for a date and time slot through Klook checkout and returns the Booking Reference ID. With use_klookcash set, it ticks KlookCash in the Discount section, which works only with at least 10 KlookCash and not on Klook Passes, e-Gift Cards, Travel Insurance, Stay+ packages or selected events. If checkout asks for extra authentication, the call stops and returns a link for you to finish it. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/klook/book_activity

  Input

  Input: book_activity

  Parameter	Type	Description
  activity_id required	string	Activity ID from search_activities.
  package_id required	string	Package from get_activity.
  date required	date	Participation date.
  time_slot	string	Time from check_availability, if the package has slots.
  units required	object	Quantity per unit type, e.g. { "adult": 2, "child": 1 }.
  use_klookcash	boolean	Apply KlookCash at checkout where Klook allows it. Default: false.

  Example response

  {
    "booking_ref": "KPR834512",
    "status": "confirmed",
    "activity": "Mount Fuji One Day Tour from Tokyo",
    "date": "2026-11-14",
    "time_slot": "08:00",
    "units": {
      "adult": 2
    },
    "subtotal": {
      "amount": 186.4,
      "currency": "USD"
    },
    "klookcash_discount": {
      "amount": 12,
      "currency": "USD"
    },
    "total_paid": {
      "amount": 174.4,
      "currency": "USD"
    }
  }

• POST

  amend_booking

  Change the participation date or contact info of a booking that allows Amend booking.

  asks first write

  Changes the participation date, the traveler contact info or both. It works only on bookings where Klook offers Amend booking: not with a No cancellation or Conditional cancellation policy, and not for vouchers whose codes do not begin with KLK. Klook then emails a booking change confirmation and an updated voucher. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/klook/amend_booking

  Input

  Input: amend_booking

  Parameter	Type	Description
  booking_ref required	string	Booking Reference ID from list_bookings, e.g. ABC123456.
  date	date	New participation date.
  contact	object	Traveler contact info to change, as the Amend booking form shows it.

  Example response

  {
    "booking_ref": "NJT204518",
    "status": "amended",
    "activity": "Nami Island and Petite France Day Tour from Seoul",
    "old_date": "2026-11-21",
    "date": "2026-11-22"
  }

• POST

  cancel_booking

  Cancel a booking and apply for a refund, where it has free cancellation.

  asks first write

  Applies for a refund on a booking within the free cancellation period stated on the booking, for all units or for the quantity you set. Klook emails a cancellation confirmation, and the previous voucher can no longer be used. For conditional cancellation Klook asks you to contact Klook Customer Support, and the tool stops and says so; with No cancellation there is no refund. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/klook/cancel_booking

  Input

  Input: cancel_booking

  Parameter	Type	Description
  booking_ref required	string	Booking Reference ID from list_bookings, e.g. ABC123456.
  quantity	integer	Units to cancel. Default: all.
  reason	string	Reason for the refund form.

  Example response

  {
    "booking_ref": "BKK771903",
    "status": "refund_requested",
    "quantity_cancelled": 2,
    "reason": "Change of plans",
    "refund": {
      "amount": 64,
      "currency": "USD"
    }
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.