Search flights, hotels, tours, cars, parking and insurance; manage Airsockfly bookings.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional agent token for account tools (bookings, points, alerts). Public search tools work without it.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Accept the changed price of an order after create_booking returned price_changed, and continue to payment.
Order identifier from list_bookings or create_booking.
Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http airsockfly https://www.airsockfly.com/api/mcp
Headers
Authorization (optional, not in the config above): Optional agent token for account tools (bookings, points, alerts). Public search tools work without it.Accept the changed price of an order after create_booking returned price_changed, and continue to payment.
| Argument | Type | Description |
|---|---|---|
| orderId | string | Order identifier from list_bookings or create_booking. |
| idempotencyKey | string | Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate. |
{
"type": "object",
"properties": {
"orderId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Order identifier from list_bookings or create_booking."
},
"idempotencyKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 100,
"minLength": 8,
"description": "Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate."
}
}
}Cancel a booking. This is irreversible: call preview_cancellation, tell the user the penalty and refund, and set confirm to true only after the user explicitly agreed.
| Argument | Type | Description |
|---|---|---|
| reason | string | Short reason given by the user. |
| confirm* | boolean | Must be true. Set it only after the user explicitly confirmed this action. |
| vertical* | string | Service type. |
| bookingId* | string | Identifier of one booking inside an order, from get_booking. |
{
"type": "object",
"required": [
"vertical",
"bookingId",
"confirm"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Short reason given by the user."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true. Set it only after the user explicitly confirmed this action."
},
"vertical": {
"enum": [
"flight",
"hotel",
"tour",
"car",
"insurance",
"parking"
],
"type": "string",
"description": "Service type."
},
"bookingId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Identifier of one booking inside an order, from get_booking."
}
}
}Reserve an offer for the user: re-prices the offer, holds availability and creates an order awaiting payment. Ask the user to confirm the offer, travellers and contact details first. When the result is price_changed, show the new price and call accept_price_change only if the user agrees.
| Argument | Type | Description |
|---|---|---|
| contact* | object | Contact details for booking confirmations. |
| endDate | string | End date of the service, YYYY-MM-DD, when the offer does not fix it. |
| currency | string | Charge currency as an ISO 4217 code. Defaults to PLN. |
| vertical* | string | Service type. |
| startDate | string | Start date of the service, YYYY-MM-DD, when the offer does not fix it. |
| couponCode | string | Discount code. |
| externalId* | string | Offer identifier (externalId) returned by a search tool. |
| travellers* | array | People travelling or insured. The first one is the lead traveller and the main driver. |
| vehiclePlate | string | Vehicle registration number. Required for parking. |
| idempotencyKey* | string | Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate. |
| insuranceAddon | string | Optional travel insurance variant added to the booking. |
| driverLicenseYears | integer | Years the main driver has held a driving licence. |
{
"type": "object",
"required": [
"vertical",
"externalId",
"travellers",
"contact",
"idempotencyKey"
],
"properties": {
"contact": {
"type": "object",
"required": [
"email",
"phone"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "E-mail address for confirmations."
},
"phone": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Phone number without the country prefix."
},
"phonePrefix": {
"type": "string",
"pattern": "^\\+\\d{1,4}$",
"description": "International dialling prefix, for example +48. Defaults to +48."
}
},
"description": "Contact details for booking confirmations."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date of the service, YYYY-MM-DD, when the offer does not fix it."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Charge currency as an ISO 4217 code. Defaults to PLN."
},
"vertical": {
"enum": [
"flight",
"hotel",
"tour",
"car",
"insurance",
"parking"
],
"type": "string",
"description": "Service type."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date of the service, YYYY-MM-DD, when the offer does not fix it."
},
"couponCode": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Discount code."
},
"externalId": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Offer identifier (externalId) returned by a search tool."
},
"travellers": {
"type": "array",
"items": {
"type": "object",
"required": [
"firstName",
"lastName",
"birthDate"
],
"properties": {
"gender": {
"enum": [
"m",
"f"
],
"type": "string",
"description": "Gender as in the travel document. Airlines require it for flight bookings."
},
"lastName": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Last name as in the travel document."
},
"birthDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date of birth, YYYY-MM-DD."
},
"firstName": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "First name as in the travel document."
},
"citizenship": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Citizenship as a two-letter ISO country code."
}
}
},
"maxItems": 9,
"minItems": 1,
"description": "People travelling or insured. The first one is the lead traveller and the main driver."
},
"vehiclePlate": {
"type": "string",
"pattern": "^[A-Za-z0-9 -]{2,14}$",
"description": "Vehicle registration number. Required for parking."
},
"idempotencyKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 100,
"minLength": 8,
"description": "Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate."
},
"insuranceAddon": {
"enum": [
"basic",
"comfort",
"premium"
],
"type": "string",
"description": "Optional travel insurance variant added to the booking."
},
"driverLicenseYears": {
"type": "integer",
"maximum": 80,
"minimum": 0,
"description": "Years the main driver has held a driving licence."
}
}
}Create a price alert for an offer. The user is notified when the price drops to the threshold.
| Argument | Type | Description |
|---|---|---|
| title* | string | Alert name shown to the user. |
| subtitle | string | Optional second line shown with the alert. |
| vertical* | string | Service type. |
| externalId* | string | Offer identifier (externalId) returned by a search tool. |
| thresholdGrosze* | integer | Notify when the price drops to this amount or lower, in grosze (1/100 PLN). |
{
"type": "object",
"required": [
"vertical",
"externalId",
"title",
"thresholdGrosze"
],
"properties": {
"title": {
"type": "string",
"maxLength": 140,
"minLength": 1,
"description": "Alert name shown to the user."
},
"subtitle": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Optional second line shown with the alert."
},
"vertical": {
"enum": [
"flight",
"hotel",
"tour",
"car",
"insurance",
"parking"
],
"type": "string",
"description": "Service type."
},
"externalId": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Offer identifier (externalId) returned by a search tool."
},
"thresholdGrosze": {
"type": "integer",
"maximum": 100000000,
"minimum": 100,
"description": "Notify when the price drops to this amount or lower, in grosze (1/100 PLN)."
}
}
}Open a support case with Airsockfly customer service about a booking or another issue.
| Argument | Type | Description |
|---|---|---|
| message* | string | Description of the issue, at least 10 characters. |
| subject* | string | Short subject of the case. |
| category* | string | What the case is about. |
| vertical* | string | Service type. |
| bookingRef | string | Order or booking number the case is about. |
{
"type": "object",
"required": [
"vertical",
"category",
"subject",
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000,
"minLength": 10,
"description": "Description of the issue, at least 10 characters."
},
"subject": {
"type": "string",
"maxLength": 140,
"minLength": 3,
"description": "Short subject of the case."
},
"category": {
"enum": [
"change",
"cancel",
"refund",
"disruption",
"payment",
"claim",
"eu261",
"other"
],
"type": "string",
"description": "What the case is about."
},
"vertical": {
"enum": [
"flight",
"hotel",
"tour",
"car",
"insurance"
],
"type": "string",
"description": "Service type."
},
"bookingRef": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Order or booking number the case is about."
}
}
}Delete one of the user's price alerts.
| Argument | Type | Description |
|---|---|---|
| id* | string | Alert identifier from list_price_alerts. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Alert identifier from list_price_alerts."
}
}
}Read one order with its bookings, insurance policies, vouchers and invoice reference.
| Argument | Type | Description |
|---|---|---|
| orderId* | string | Order identifier from list_bookings or create_booking. |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Order identifier from list_bookings or create_booking."
}
}
}Read one destination guide by slug: highlights, airports, attractions and the best time to go.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Identifier (slug) returned by the listing tool. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Identifier (slug) returned by the listing tool."
}
}
}Get the fare rules of a flight offer: baggage, changes and refunds. The offer is re-priced with the airline on the first call.
| Argument | Type | Description |
|---|---|---|
| externalId* | string | Offer identifier (externalId) returned by a search tool. |
{
"type": "object",
"required": [
"externalId"
],
"properties": {
"externalId": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Offer identifier (externalId) returned by a search tool."
}
}
}Read the user's loyalty points balance and recent point history.
No arguments.
{
"type": "object",
"properties": {}
}Refresh one offer by its externalId before booking. Returns the current price, availability, cancellation policy and details, or not_found when the offer has expired.
| Argument | Type | Description |
|---|---|---|
| vertical* | string | Service type. |
| externalId* | string | Offer identifier (externalId) returned by a search tool. |
{
"type": "object",
"required": [
"vertical",
"externalId"
],
"properties": {
"vertical": {
"enum": [
"flight",
"hotel",
"tour",
"car",
"insurance",
"parking"
],
"type": "string",
"description": "Service type."
},
"externalId": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Offer identifier (externalId) returned by a search tool."
}
}
}Check whether an order has been paid and confirmed.
| Argument | Type | Description |
|---|---|---|
| orderId* | string | Order identifier from list_bookings or create_booking. |
{
"type": "object",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Order identifier from list_bookings or create_booking."
}
}
}Read the signed-in user's profile and travel preferences such as language, currency and home airport.
No arguments.
{
"type": "object",
"properties": {}
}List the user's orders, newest first, with status and totals.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
| status | string | Show only orders with this status. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum number of items to return."
},
"status": {
"enum": [
"draft",
"awaitingPayment",
"paid",
"confirmed",
"paymentFailed",
"cancelled",
"refunded"
],
"type": "string",
"description": "Show only orders with this status."
}
}
}List travel destination guides published on Airsockfly, with hints for searching each destination.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of items to return."
}
}
}Read Airsockfly frequently asked questions about booking, payments and cancellations.
| Argument | Type | Description |
|---|---|---|
| audience | string | FAQ group to read. |
{
"type": "object",
"properties": {
"audience": {
"enum": [
"help",
"home"
],
"type": "string",
"description": "FAQ group to read."
}
}
}Read the user's in-app notifications, newest first.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum number of items to return."
}
}
}List the user's price alerts.
No arguments.
{
"type": "object",
"properties": {}
}List rewards the user can get for loyalty points, with their cost in points and remaining stock.
No arguments.
{
"type": "object",
"properties": {}
}List offers and collections the user saved.
No arguments.
{
"type": "object",
"properties": {}
}List the user's support cases and their status.
No arguments.
{
"type": "object",
"properties": {}
}List travellers saved by the user with names and birth dates. Document numbers are never returned. Use them to fill create_booking.
No arguments.
{
"type": "object",
"properties": {}
}Show what cancelling a booking would cost: penalty, refund and the deadline for free cancellation.
| Argument | Type | Description |
|---|---|---|
| vertical* | string | Service type. |
| bookingId* | string | Identifier of one booking inside an order, from get_booking. |
{
"type": "object",
"required": [
"vertical",
"bookingId"
],
"properties": {
"vertical": {
"enum": [
"flight",
"hotel",
"tour",
"car",
"insurance",
"parking"
],
"type": "string",
"description": "Service type."
},
"bookingId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Identifier of one booking inside an order, from get_booking."
}
}
}Exchange loyalty points for a reward. This spends points: confirm the reward and its cost with the user and set confirm to true only after explicit agreement. Physical rewards need a shipping address.
| Argument | Type | Description |
|---|---|---|
| city | string | City for shipping a physical reward. |
| slug* | string | Reward identifier (slug) from list_rewards. |
| phone | string | Phone number without the country prefix. |
| street | string | Street and number for shipping a physical reward. |
| confirm* | boolean | Must be true. Set it only after the user explicitly confirmed this action. |
| fullName | string | Recipient name for shipping a physical reward. |
| postalCode | string | Postal code for shipping a physical reward. |
| countryCode | string | Shipping country as a two-letter ISO code. |
| idempotencyKey* | string | Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate. |
{
"type": "object",
"required": [
"slug",
"idempotencyKey",
"confirm"
],
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "City for shipping a physical reward."
},
"slug": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Reward identifier (slug) from list_rewards."
},
"phone": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Phone number without the country prefix."
},
"street": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Street and number for shipping a physical reward."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true. Set it only after the user explicitly confirmed this action."
},
"fullName": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Recipient name for shipping a physical reward."
},
"postalCode": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Postal code for shipping a physical reward."
},
"countryCode": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Shipping country as a two-letter ISO code."
},
"idempotencyKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 100,
"minLength": 8,
"description": "Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate."
}
}
}Ask to move the dates of a hotel, tour or car rental booking. Creates a change request that the provider handles.
| Argument | Type | Description |
|---|---|---|
| note | string | Optional note for the service provider. |
| vertical* | string | Service type. |
| bookingId* | string | Identifier of one booking inside an order, from get_booking. |
| newEndDate* | string | New end date, YYYY-MM-DD. |
| newStartDate* | string | New start date, YYYY-MM-DD. |
{
"type": "object",
"required": [
"vertical",
"bookingId",
"newStartDate",
"newEndDate"
],
"properties": {
"note": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Optional note for the service provider."
},
"vertical": {
"enum": [
"hotel",
"tour",
"car"
],
"type": "string",
"description": "Service type."
},
"bookingId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Identifier of one booking inside an order, from get_booking."
},
"newEndDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "New end date, YYYY-MM-DD."
},
"newStartDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "New start date, YYYY-MM-DD."
}
}
}Search car rentals for a pickup place, date and time. Prices cover the whole rental; the drop-off place defaults to the pickup place.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of offers to return, from 1 to 30. Default 10. |
| driverAge | integer | Age of the main driver. |
| pickupDate* | string | Pickup date, YYYY-MM-DD. |
| pickupTime | string | Pickup time, HH:MM local time. |
| dropoffDate* | string | Drop-off date, YYYY-MM-DD. |
| dropoffTime | string | Drop-off time, HH:MM local time. |
| pickupLocation* | string | Pickup place: city, airport or address. |
| dropoffLocation | string | Drop-off place. Defaults to the pickup place. |
{
"type": "object",
"required": [
"pickupLocation",
"pickupDate",
"dropoffDate"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"description": "Maximum number of offers to return, from 1 to 30. Default 10."
},
"driverAge": {
"type": "integer",
"maximum": 99,
"minimum": 18,
"description": "Age of the main driver."
},
"pickupDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Pickup date, YYYY-MM-DD."
},
"pickupTime": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Pickup time, HH:MM local time."
},
"dropoffDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Drop-off date, YYYY-MM-DD."
},
"dropoffTime": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Drop-off time, HH:MM local time."
},
"pickupLocation": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Pickup place: city, airport or address."
},
"dropoffLocation": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Drop-off place. Defaults to the pickup place."
}
}
}Search flights between two airports or cities. Returns offers with the price in grosze, schedule, fare family and a link to the offer page. Use suggest_places first when you only know a city name.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of offers to return, from 1 to 30. Default 10. |
| adults | integer | Number of adults. |
| toCity | string | Arrival city name. Defaults to the IATA code. |
| toCode* | string | IATA code of the arrival airport or city, for example BCN. |
| infants | integer | Number of infants under 2 travelling on an adult's lap. |
| children | integer | Number of children aged 2 to 17. |
| fromCity | string | Departure city name. Defaults to the IATA code. |
| fromCode* | string | IATA code of the departure airport or city, for example WAW. |
| cabinClass | string | Cabin class. |
| returnDate | string | Return date, YYYY-MM-DD. Omit for a one-way flight. |
| childrenAges | array | Age of each child in years, in the same order as children. |
| departureDate* | string | Outbound date, YYYY-MM-DD. |
| includeNearby | boolean | Also search nearby alternative airports. |
{
"type": "object",
"required": [
"fromCode",
"toCode",
"departureDate"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"description": "Maximum number of offers to return, from 1 to 30. Default 10."
},
"adults": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Number of adults."
},
"toCity": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Arrival city name. Defaults to the IATA code."
},
"toCode": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "IATA code of the arrival airport or city, for example BCN."
},
"infants": {
"type": "integer",
"maximum": 4,
"minimum": 0,
"description": "Number of infants under 2 travelling on an adult's lap."
},
"children": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "Number of children aged 2 to 17."
},
"fromCity": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Departure city name. Defaults to the IATA code."
},
"fromCode": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "IATA code of the departure airport or city, for example WAW."
},
"cabinClass": {
"enum": [
"economy",
"premium",
"business"
],
"type": "string",
"description": "Cabin class."
},
"returnDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Return date, YYYY-MM-DD. Omit for a one-way flight."
},
"childrenAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 17,
"minimum": 2
},
"maxItems": 8,
"description": "Age of each child in years, in the same order as children."
},
"departureDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Outbound date, YYYY-MM-DD."
},
"includeNearby": {
"type": "boolean",
"description": "Also search nearby alternative airports."
}
}
}Search hotels in a city or area for given check-in and check-out dates. Returns offers with the total price of the stay, rating, board type and a link to the offer page.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of offers to return, from 1 to 30. Default 10. |
| place* | string | City or area where the hotel should be. |
| rooms | integer | Number of rooms. |
| adults | integer | Number of adults. |
| checkIn* | string | Check-in date, YYYY-MM-DD. |
| checkOut* | string | Check-out date, YYYY-MM-DD. |
{
"type": "object",
"required": [
"place",
"checkIn",
"checkOut"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"description": "Maximum number of offers to return, from 1 to 30. Default 10."
},
"place": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "City or area where the hotel should be."
},
"rooms": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "Number of rooms."
},
"adults": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Number of adults."
},
"checkIn": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-in date, YYYY-MM-DD."
},
"checkOut": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out date, YYYY-MM-DD."
}
}
}Get travel insurance quotes for a trip: destination, dates and the age of every insured person. Premiums are calculated by the server.
| Argument | Type | Description |
|---|---|---|
| type | string | Insurance type. |
| limit | integer | Maximum number of offers to return, from 1 to 30. Default 10. |
| endDate* | string | End date, YYYY-MM-DD. |
| startDate* | string | Start date, YYYY-MM-DD. |
| destination* | string | Destination country or region of the trip. |
| travellerAges* | array | Age of every insured person. |
{
"type": "object",
"required": [
"destination",
"startDate",
"endDate",
"travellerAges"
],
"properties": {
"type": {
"enum": [
"travel",
"medical",
"cancellation",
"luggage",
"sport"
],
"type": "string",
"description": "Insurance type."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"description": "Maximum number of offers to return, from 1 to 30. Default 10."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date, YYYY-MM-DD."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date, YYYY-MM-DD."
},
"destination": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Destination country or region of the trip."
},
"travellerAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 120,
"minimum": 0
},
"maxItems": 20,
"minItems": 1,
"description": "Age of every insured person."
}
}
}Search airport and city parking for an entry and exit date. Prices cover every calendar day from entry to exit inclusive.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of offers to return, from 1 to 30. Default 10. |
| endDate* | string | Exit date, YYYY-MM-DD. |
| endTime | string | Exit time, HH:MM local time of the car park. |
| location | string | City, airport or area of the car park. Leave empty to search everywhere. |
| startDate* | string | Entry date, YYYY-MM-DD. |
| startTime | string | Entry time, HH:MM local time of the car park. |
{
"type": "object",
"required": [
"startDate",
"endDate"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"description": "Maximum number of offers to return, from 1 to 30. Default 10."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Exit date, YYYY-MM-DD."
},
"endTime": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Exit time, HH:MM local time of the car park."
},
"location": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "City, airport or area of the car park. Leave empty to search everywhere."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Entry date, YYYY-MM-DD."
},
"startTime": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Entry time, HH:MM local time of the car park."
}
}
}Search package holidays and tours to a destination, departing from a given city within a date window.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of offers to return, from 1 to 30. Default 10. |
| adults | integer | Number of adults. |
| endDate* | string | End date, YYYY-MM-DD. |
| fromCity* | string | City the trip departs from. |
| startDate* | string | Start date, YYYY-MM-DD. |
| destination* | string | Holiday destination: country, region or city. |
{
"type": "object",
"required": [
"destination",
"fromCity",
"startDate",
"endDate"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"description": "Maximum number of offers to return, from 1 to 30. Default 10."
},
"adults": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Number of adults."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date, YYYY-MM-DD."
},
"fromCity": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "City the trip departs from."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date, YYYY-MM-DD."
},
"destination": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Holiday destination: country, region or city."
}
}
}Start payment for an order and get a secure Stripe checkout URL. The user must open the URL and pay personally. The agent never pays and must not claim that a payment was made.
| Argument | Type | Description |
|---|---|---|
| method* | string | Payment method the user will use on the payment page. |
| orderId* | string | Order identifier from list_bookings or create_booking. |
{
"type": "object",
"required": [
"orderId",
"method"
],
"properties": {
"method": {
"enum": [
"blik",
"card",
"transfer"
],
"type": "string",
"description": "Payment method the user will use on the payment page."
},
"orderId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$",
"description": "Order identifier from list_bookings or create_booking."
}
}
}Resolve a city, airport or region name to place suggestions with IATA codes that the search tools accept.
| Argument | Type | Description |
|---|---|---|
| query* | string | Text to look up, for example a city or airport name. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Text to look up, for example a city or airport name."
}
}
}Save an offer to the user's favourites, or remove it when it is already saved.
| Argument | Type | Description |
|---|---|---|
| vertical* | string | Service type. |
| externalId* | string | Offer identifier (externalId) returned by a search tool. |
{
"type": "object",
"required": [
"vertical",
"externalId"
],
"properties": {
"vertical": {
"enum": [
"flight",
"hotel",
"tour",
"car",
"insurance",
"parking"
],
"type": "string",
"description": "Service type."
},
"externalId": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "Offer identifier (externalId) returned by a search tool."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.