Tiqets API and MCP server

• POST

  search_experiences

  Attractions, museums and tours on Tiqets by text and city, with price from.

  read

  Returns matching products, best match first, with the product ID, city and the lowest price shown. Use product_id in get_experience and check_availability. Pages hold up to 50 results.

  POST /api/v1/tiqets/search_experiences

  Input

  Input: search_experiences

  Parameter	Type	Description
  query required	string	What to look for, e.g. "Vatican" or "boat tour".
  city	string	City name to narrow the results.
  limit	integer	1 to 50. Default: 20.

  Example response

  {
    "results": [
      {
        "product_id": "1089412",
        "title": "Vatican Museums and Sistine Chapel: Skip-the-Line Ticket",
        "city": "Rome",
        "price_from": {
          "amount": 32,
          "currency": "EUR"
        },
        "url": "https://www.tiqets.com/en/rome-attractions-c71/vatican-museums-p1089412/"
      }
    ]
  }

• POST

  get_experience

  Product page: what is included, meeting point, instructions and cancellation terms.

  read

  Returns the details Tiqets shows on the product page. Cancellation terms tell your agent whether free cancellation is on offer before you book.

  POST /api/v1/tiqets/get_experience

  Input

  Input: get_experience

  Parameter	Type	Description
  product_id required	string	Product ID from search_experiences.

  Example response

  {
    "product_id": "1089412",
    "title": "Vatican Museums and Sistine Chapel: Skip-the-Line Ticket",
    "city": "Rome",
    "includes": [
      "Entry to the Vatican Museums",
      "Entry to the Sistine Chapel"
    ],
    "free_cancellation": "Until 23:59 the day before the visit"
  }

• POST

  check_availability

  Ticket types, timeslots and prices for a product on a date.

  read

  Returns what Tiqets shows for that product on that day: ticket types with prices and, for timed products, the free timeslots in order. An empty list means nothing is available that day. Pass a ticket type ID to start_checkout.

  POST /api/v1/tiqets/check_availability

  Input

  Input: check_availability

  Parameter	Type	Description
  product_id required	string	Product ID from search_experiences.
  date required	date	Visit date.

  Example response

  {
    "product_id": "1089412",
    "date": "2026-10-18",
    "timeslots": [
      {
        "time": "09:00",
        "available": true
      },
      {
        "time": "11:30",
        "available": true
      }
    ],
    "ticket_types": [
      {
        "id": "adult",
        "label": "Adult",
        "price": {
          "amount": 32,
          "currency": "EUR"
        }
      }
    ]
  }

• POST

  list_bookings

  Your bookings with product, visit date, tickets and status.

  read

  Lists the bookings of the signed-in account, soonest visit first. Use order_id in get_booking, download_tickets and cancel_booking.

  POST /api/v1/tiqets/list_bookings

  Input

  Input: list_bookings

  Parameter	Type	Description
  when	enum	upcoming, past or all. Default: upcoming.

  Example response

  {
    "bookings": [
      {
        "order_id": "71204583",
        "product": "Sagrada Familia: Fast Track Ticket",
        "visit_date": "2026-10-24",
        "tickets": 2,
        "status": "confirmed"
      }
    ]
  }

• POST

  get_booking

  One booking: tickets, price paid and whether it can be cancelled or rescheduled.

  read

  Returns the order as the account shows it: product, visit date, tickets, price paid and whether cancelling or rescheduling is on offer. Check it before cancel_booking or reschedule_booking.

  POST /api/v1/tiqets/get_booking

  Input

  Input: get_booking

  Parameter	Type	Description
  order_id required	string	Order ID from list_bookings.

  Example response

  {
    "order_id": "71204583",
    "product": "Sagrada Familia: Fast Track Ticket",
    "visit_date": "2026-10-24",
    "tickets": [
      {
        "type": "Adult",
        "quantity": 2
      }
    ],
    "total_paid": {
      "amount": 66,
      "currency": "EUR"
    },
    "can_cancel": true,
    "can_reschedule": true
  }

• POST

  download_tickets

  Download links for the e-tickets of one booking.

  read

  Returns links to the ticket files of the order, in the format Tiqets provides for that product. Links are for you only; do not share them.

  POST /api/v1/tiqets/download_tickets

  Input

  Input: download_tickets

  Parameter	Type	Description
  order_id required	string	Order ID from list_bookings.

  Example response

  {
    "order_id": "71204583",
    "files": [
      {
        "name": "sagrada-familia-ticket-1.pdf",
        "url": "https://example-download.invalid/t/71204583-1"
      }
    ]
  }

• POST

  start_checkout

  Fill the order and return the Tiqets checkout link. Nothing is charged until you pay there yourself.

  write

  Prepares an order for the product, date and tickets and returns the Tiqets checkout link. It does not pay and charges nothing. It reaches no one, so it runs without asking; you finish the payment on Tiqets.

  POST /api/v1/tiqets/start_checkout

  Input

  Input: start_checkout

  Parameter	Type	Description
  product_id required	string	Product ID from search_experiences.
  date required	date	Visit date.
  timeslot	string	Start time from check_availability, for timed products.
  tickets required	object	Ticket type ID to quantity, e.g. {"adult": 2}.

  Example response

  {
    "product_id": "1089412",
    "date": "2026-10-18",
    "timeslot": "09:00",
    "tickets": {
      "adult": 2
    },
    "total": {
      "amount": 64,
      "currency": "EUR"
    },
    "checkout_url": "https://example-checkout.invalid/c/9f3a"
  }

• POST

  reschedule_booking

  Move a booking to another date or timeslot, where Tiqets offers rescheduling.

  asks first write

  Changes the visit date or timeslot of one order, only for products where Tiqets offers it; get_booking says so. It changes your booking with the vendor. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/tiqets/reschedule_booking

  Input

  Input: reschedule_booking

  Parameter	Type	Description
  order_id required	string	Order ID from list_bookings.
  date required	date	New visit date.
  timeslot	string	New start time, for timed products.

  Example response

  {
    "order_id": "71204583",
    "status": "rescheduled",
    "visit_date": "2026-10-24",
    "timeslot": "14:00"
  }

• POST

  cancel_booking

  Cancel a whole booking, where Tiqets allows it.

  asks first write

  Cancels one whole order; partial cancellation is not offered. Free cancellation applies only if you chose it at booking, and runs until 23:59 on the day before the visit. Check get_booking first. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/tiqets/cancel_booking

  Input

  Input: cancel_booking

  Parameter	Type	Description
  order_id required	string	Order ID from list_bookings.

  Example response

  {
    "order_id": "71204583",
    "status": "cancelled",
    "product": "Sagrada Familia: Fast Track Ticket",
    "visit_date": "2026-10-24",
    "refund": {
      "amount": 66,
      "currency": "EUR"
    }
  }

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.