MCP tools reference

Tiqets MCP tools

9 tools for Tiqets on the Cotlet MCP server. Your agent picks them from tools/list.

MCP server
https://cotlet.dev/mcp/v1
Connects with
Your own Tiqets account (the account you booked with)
Integration page
Tiqets
Tiqets Endpoints
Endpoint Access Description
tiqets_search_experiences read Attractions, museums and tours on Tiqets by text and city, with price from.
tiqets_get_experience read Product page: what is included, meeting point, instructions and cancellation terms.
tiqets_check_availability read Ticket types, timeslots and prices for a product on a date.
tiqets_list_bookings read Your bookings with product, visit date, tickets and status.
tiqets_get_booking read One booking: tickets, price paid and whether it can be cancelled or rescheduled.
tiqets_download_tickets read Download links for the e-tickets of one booking.
tiqets_start_checkout write Fill the order and return the Tiqets checkout link. Nothing is charged until you pay there yourself.
tiqets_reschedule_booking write Move a booking to another date or timeslot, where Tiqets offers rescheduling.
tiqets_cancel_booking write Cancel a whole booking, where Tiqets allows it.

Search experiences

read

MCP tool tiqets_search_experiences

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.

Parameters

Parameters: search_experiences
NameTypeDescription
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.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_search_experiences",
    "arguments": {
      "query": "Vatican"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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/"
      }
    ]
  },
  "isError": false
}

Get experience

read

MCP tool tiqets_get_experience

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

Parameters

Parameters: get_experience
NameTypeDescription
product_id required string Product ID from search_experiences.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_get_experience",
    "arguments": {
      "product_id": "product_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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"
  },
  "isError": false
}

Check availability

read

MCP tool tiqets_check_availability

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.

Parameters

Parameters: check_availability
NameTypeDescription
product_id required string Product ID from search_experiences.
date required date Visit date.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_check_availability",
    "arguments": {
      "product_id": "1089412",
      "date": "2026-10-18"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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"
        }
      }
    ]
  },
  "isError": false
}

List bookings

read

MCP tool tiqets_list_bookings

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

Parameters

Parameters: list_bookings
NameTypeDescription
when enum upcoming, past or all. Default: upcoming.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_list_bookings",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "bookings": [
      {
        "order_id": "71204583",
        "product": "Sagrada Familia: Fast Track Ticket",
        "visit_date": "2026-10-24",
        "tickets": 2,
        "status": "confirmed"
      }
    ]
  },
  "isError": false
}

Get booking

read

MCP tool tiqets_get_booking

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.

Parameters

Parameters: get_booking
NameTypeDescription
order_id required string Order ID from list_bookings.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_get_booking",
    "arguments": {
      "order_id": "order_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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
  },
  "isError": false
}

Download tickets

read

MCP tool tiqets_download_tickets

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.

Parameters

Parameters: download_tickets
NameTypeDescription
order_id required string Order ID from list_bookings.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_download_tickets",
    "arguments": {
      "order_id": "order_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "order_id": "71204583",
    "files": [
      {
        "name": "sagrada-familia-ticket-1.pdf",
        "url": "https://example-download.invalid/t/71204583-1"
      }
    ]
  },
  "isError": false
}

Start checkout

write

MCP tool tiqets_start_checkout

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.

Parameters

Parameters: start_checkout
NameTypeDescription
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}.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_start_checkout",
    "arguments": {
      "product_id": "product_8c41d2",
      "date": "2026-10-01",
      "tickets": "tickets"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "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"
  },
  "isError": false
}

Reschedule booking

write Confirm

MCP tool tiqets_reschedule_booking

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.

Parameters

Parameters: reschedule_booking
NameTypeDescription
order_id required string Order ID from list_bookings.
date required date New visit date.
timeslot string New start time, for timed products.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_reschedule_booking",
    "arguments": {
      "order_id": "71311902",
      "date": "2026-10-25",
      "timeslot": "13:30"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "order_id": "71204583",
    "status": "rescheduled",
    "visit_date": "2026-10-24",
    "timeslot": "14:00"
  },
  "isError": false
}

Cancel booking

write Confirm

MCP tool tiqets_cancel_booking

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.

Parameters

Parameters: cancel_booking
NameTypeDescription
order_id required string Order ID from list_bookings.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiqets_cancel_booking",
    "arguments": {
      "order_id": "71204583"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "order_id": "71204583",
    "status": "cancelled",
    "product": "Sagrada Familia: Fast Track Ticket",
    "visit_date": "2026-10-24",
    "refund": {
      "amount": 66,
      "currency": "EUR"
    }
  },
  "isError": false
}