# Tiqets MCP tools

> Every Tiqets MCP tool on the Cotlet server: tool names, input schemas, a tools/call example and an example result for each tool.

Source: https://cotlet.dev/docs/mcp/tiqets

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

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: https://cotlet.dev/integrations/tiqets-api-mcp-server

## 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

MCP tool: `tiqets_search_experiences`

Access: 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.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | What to look for, e.g. "Vatican" or "boat tour". |
| `city` | string | no | City name to narrow the results. |
| `limit` | integer | no | 1 to 50. Default: 20. |

### tools/call

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

### Example response

```json
{
  "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

MCP tool: `tiqets_get_experience`

Access: read.

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

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `product_id` | string | yes | Product ID from search_experiences. |

### tools/call

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

### Example response

```json
{
  "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

MCP tool: `tiqets_check_availability`

Access: 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.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `product_id` | string | yes | Product ID from search_experiences. |
| `date` | date | yes | Visit date. |

### tools/call

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

### Example response

```json
{
  "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

MCP tool: `tiqets_list_bookings`

Access: read.

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

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `when` | enum | no | upcoming, past or all. Default: upcoming. |

### tools/call

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

### Example response

```json
{
  "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

MCP tool: `tiqets_get_booking`

Access: 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.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `order_id` | string | yes | Order ID from list_bookings. |

### tools/call

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

### Example response

```json
{
  "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

MCP tool: `tiqets_download_tickets`

Access: 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.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `order_id` | string | yes | Order ID from list_bookings. |

### tools/call

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

### Example response

```json
{
  "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

MCP tool: `tiqets_start_checkout`

Access: 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.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `product_id` | string | yes | Product ID from search_experiences. |
| `date` | date | yes | Visit date. |
| `timeslot` | string | no | Start time from check_availability, for timed products. |
| `tickets` | object | yes | Ticket type ID to quantity, e.g. {"adult": 2}. |

### tools/call

```json
{
  "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

```json
{
  "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

MCP tool: `tiqets_reschedule_booking`

Access: write. Confirm: waits for the user's OK before it runs.

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

| Name | Type | Required | Description |
|---|---|---|---|
| `order_id` | string | yes | Order ID from list_bookings. |
| `date` | date | yes | New visit date. |
| `timeslot` | string | no | New start time, for timed products. |

### tools/call

```json
{
  "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

```json
{
  "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

MCP tool: `tiqets_cancel_booking`

Access: write. Confirm: waits for the user's OK before it runs.

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

| Name | Type | Required | Description |
|---|---|---|---|
| `order_id` | string | yes | Order ID from list_bookings. |

### tools/call

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

### Example response

```json
{
  "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
}
```