MBD Travel

Read-only MBD Travel catalogue: tours, hotel prices, private transfers and the Dubai visa.

Should I use this

Quality & Safety

A
Description quality
98%
Schema completeness
98%
Naming quality
93%
Poisoning risk
80%
Permission match
80%
Protocol compliance
100%

Findings (5)

  • HIGHTool poisoning patterns detected
  • LOWTool 'compare_tours' description lacks action verbin compare_tours
  • LOWTool description contains role marker that could confuse chat modelsin search_transfers
  • LOWTool 'fetch' suggests web access but openWorldHint=falsein fetch
  • LOWTool 'browse_destinations' suggests web access but openWorldHint=falsein browse_destinations

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~6,232Tokens (tool definitions)
~4.8 KBTypical response size
Significant attention impact (4.87% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "travel": {
      "url": "https://mbdtravel.com/api/v1/mcp/public"
    }
  }
}

Remote endpoints

https://mbdtravel.com/api/v1/mcp/publicstreamable-http

What it can do

Tool inventory

Tools (12)

๐ŸŸข Read-only๐ŸŸก Write๐Ÿ”ด Deleteโšช Unknown
๐ŸŸขsearch(query, language, currency, limit)

Free-text search over published MBD Travel tours, experiences, hotels and the Dubai visa (examples: "Japan tour", "Dubai desert safari", "Paris hotel", "Dubai visa"; Turkish works too). Each result carries an id. Currency comes from the currency argument or the query ("dollar", "AED"), else EUR. A hotel result carries a price note, not a price. Flights, transfers, booking and payment are not in the index.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Text to search.",
      "maxLength": 200
    },
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Result language; default tr."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Maximum results per type; default 5."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "tur",
              "deneyim",
              "otel",
              "vize"
            ]
          },
          "snippet": {
            "type": "string"
          },
          "price": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "amount": {
                "type": "integer",
                "description": "Minor units."
              },
              "currency": {
                "type": "string",
                "enum": [
                  "EUR",
                  "USD",
                  "AED"
                ]
              },
              "basis": {
                "type": "string"
              }
            },
            "required": [
              "amount",
              "currency",
              "basis"
            ]
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ]
      }
    }
  },
  "required": [
    "results"
  ]
}
๐ŸŸขfetch(id)

Returns the full text, price and site link for a record id. Id format: <tur|deneyim|otel|vize>:<tr|en>:<EUR|USD|AED>:<key> (tour, experience, hotel, visa); change only the currency part to switch currency. A tour record carries itinerary, inclusions, exclusions, hotels and departures, and names what it lacks. An unpublished record returns NOT_FOUND.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Record id, format as in the tool description."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url"
  ]
}
๐ŸŸขsearch_tours(language, currency, query, country, city, ...)

Lists and filters published tours by free text, destination, maximum from-price, departure date range and sort. Prices are "from" prices with their basis, not fixed prices. Returns an empty list with emptyReason when nothing matches. Tours only: no hotels, experiences or visas.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Free text: country, city or tour name (example: \"Japan\")."
    },
    "country": {
      "type": "string",
      "maxLength": 200,
      "description": "Country: slug, name in Turkish or English, or ISO 3166-1 alpha-2 code (example: \"japonya\", \"Japan\", \"JP\")."
    },
    "city": {
      "type": "string",
      "maxLength": 200,
      "description": "City: slug or name in Turkish or English."
    },
    "maxPrice": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000000,
      "description": "Maximum from-price in the unit of priceFrom.amount (minor units: 15000 for EUR 150) and in the chosen currency."
    },
    "departureFrom": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "minLength": 10,
      "maxLength": 10,
      "description": "Tours with a departure on or after this date (YYYY-MM-DD)"
    },
    "departureTo": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "minLength": 10,
      "maxLength": 10,
      "description": "Tours with a departure on or before this date (YYYY-MM-DD)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Default 10."
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    },
    "sort": {
      "type": "string",
      "enum": [
        "name",
        "newest",
        "price",
        "departure"
      ],
      "description": "Default newest."
    }
  },
  "required": [
    "language",
    "currency"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "tours": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "airline": {
            "type": [
              "string",
              "null"
            ]
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "priceFrom": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "integer",
                    "description": "Minor units."
                  },
                  "currency": {
                    "type": "string",
                    "enum": [
                      "EUR",
                      "USD",
                      "AED"
                    ]
                  },
                  "basis": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "currency",
                  "basis"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "deepLink": {
            "type": "string"
          },
          "nextDepartureOn": {
            "type": [
              "string",
              "null"
            ]
          },
          "nightCount": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "slug",
          "name",
          "deepLink"
        ]
      }
    },
    "total": {
      "type": "integer"
    },
    "emptyReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "disclaimer": {
      "type": "string"
    },
    "deepLink": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "tours",
    "total",
    "emptyReason",
    "deepLink"
  ]
}
๐ŸŸขget_tour(language, currency, slug)

Returns one tour: description, airline, nights, day-by-day itinerary, included and excluded items, hotels, upcoming departure dates and the first departure's price per slot (adult, child). cancellation holds the fixed tour cancellation and refund policy. Fields without data are listed in missing. An unpublished tour returns PRODUCT_NOT_FOUND. Only the first departure is priced here.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "slug": {
      "type": "string",
      "maxLength": 200,
      "description": "product.slug"
    }
  },
  "required": [
    "language",
    "currency",
    "slug"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "tour": {
      "type": "object",
      "properties": {
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "airline": {
          "type": [
            "string",
            "null"
          ]
        },
        "publishedAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "priceFrom": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "amount": {
                  "type": "integer",
                  "description": "Minor units."
                },
                "currency": {
                  "type": "string",
                  "enum": [
                    "EUR",
                    "USD",
                    "AED"
                  ]
                },
                "basis": {
                  "type": "string"
                }
              },
              "required": [
                "amount",
                "currency",
                "basis"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "deepLink": {
          "type": "string"
        },
        "nextDepartureOn": {
          "type": [
            "string",
            "null"
          ]
        },
        "nightCount": {
          "type": [
            "integer",
            "null"
          ]
        },
        "itinerary": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "itineraryTruncated": {
          "type": "boolean"
        },
        "includes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "excludes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "visaNotes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "hotels": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "cancellation": {
          "type": "string"
        },
        "upcomingDepartures": {
          "type": "object"
        },
        "missing": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "slug",
        "name",
        "deepLink"
      ]
    },
    "disclaimer": {
      "type": "string"
    },
    "deepLink": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "tour",
    "deepLink"
  ]
}
๐ŸŸขget_departures(language, currency, slug, from, to, ...)

Returns a tour's departures with the price of every occupancy slot for each (adult, single, extra bed, children, infant). Prices are not trimmed; every occupancy slot is listed. Past departures are excluded. Paged by date: default 12 per page; nextCursor is the cursor of the next page. The dates returned are the only departure dates the catalogue holds.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "slug": {
      "type": "string",
      "maxLength": 200
    },
    "from": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "minLength": 10,
      "maxLength": 10,
      "description": "Departures on or after this date (YYYY-MM-DD)"
    },
    "to": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "minLength": 10,
      "maxLength": 10,
      "description": "Departures on or before this date (YYYY-MM-DD)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Departures per page. Default 12."
    },
    "cursor": {
      "type": "string",
      "maxLength": 500,
      "description": "nextCursor from the previous response."
    }
  },
  "required": [
    "language",
    "currency",
    "slug"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cursor of the next page; null on the last page."
    },
    "departures": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "departureId": {
            "type": "string"
          },
          "departureOn": {
            "type": "string"
          },
          "prices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "amount": {
                  "type": "integer",
                  "description": "Minor units."
                },
                "currency": {
                  "type": "string",
                  "enum": [
                    "EUR",
                    "USD",
                    "AED"
                  ]
                },
                "basis": {
                  "type": "string"
                },
                "slot": {
                  "type": "string"
                }
              },
              "required": [
                "slot",
                "amount",
                "currency",
                "basis"
              ]
            }
          },
          "deepLink": {
            "type": "string"
          }
        },
        "required": [
          "departureId",
          "departureOn",
          "prices"
        ]
      }
    },
    "emptyReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "disclaimer": {
      "type": "string"
    },
    "deepLink": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "departures",
    "total",
    "nextCursor",
    "emptyReason",
    "deepLink"
  ]
}
๐ŸŸขbrowse_destinations(language, currency, scope, country)

Lists catalogue countries and cities with their published tour counts. scope: countries, cities (of one country) or featured (default: the cities MBD Travel highlights). There is no continent, region or theme grouping. Returns destinations only, not tours.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "scope": {
      "type": "string",
      "enum": [
        "countries",
        "cities",
        "featured"
      ],
      "description": "featured = highlighted cities (default)."
    },
    "country": {
      "type": "string",
      "maxLength": 200,
      "description": "Country (slug, Turkish or English name, or ISO code); returns that countryโ€™s cities."
    }
  },
  "required": [
    "language",
    "currency"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "publishedTourCount": {
            "type": [
              "integer",
              "null"
            ]
          },
          "featuredCityCount": {
            "type": [
              "integer",
              "null"
            ]
          },
          "deepLink": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "deepLink"
        ]
      }
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "countrySlug": {
            "type": [
              "string",
              "null"
            ]
          },
          "countryName": {
            "type": [
              "string",
              "null"
            ]
          },
          "isFeatured": {
            "type": "boolean"
          },
          "publishedTourCount": {
            "type": [
              "integer",
              "null"
            ]
          },
          "deepLink": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "deepLink"
        ]
      }
    },
    "disclaimer": {
      "type": "string"
    },
    "deepLink": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "countries",
    "cities",
    "deepLink"
  ]
}
๐ŸŸขcompare_tours(language, currency, slugs)

Puts two to four tours side by side with the same fields. It returns every field of each tour. It gives no winner, score or verdict; null fields stay null.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "slugs": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "minItems": 2,
      "maxItems": 4,
      "uniqueItems": true
    }
  },
  "required": [
    "language",
    "currency",
    "slugs"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "tours": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "airline": {
            "type": [
              "string",
              "null"
            ]
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "priceFrom": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "integer",
                    "description": "Minor units."
                  },
                  "currency": {
                    "type": "string",
                    "enum": [
                      "EUR",
                      "USD",
                      "AED"
                    ]
                  },
                  "basis": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "currency",
                  "basis"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "deepLink": {
            "type": "string"
          },
          "nextDepartureOn": {
            "type": [
              "string",
              "null"
            ]
          },
          "nightCount": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "slug",
          "name",
          "deepLink"
        ]
      }
    },
    "disclaimer": {
      "type": "string"
    },
    "deepLink": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "tours",
    "deepLink"
  ]
}
๐ŸŸขfind_last_minute_tours(language, currency, limit)

Returns tours departing soon, soonest first, with dates. Covers last minute, near-term, urgent, right away, this week and tour at airfare price requests. Selection is by departure date only; it is not a discount. windowDays states the length of the window in days. It has no date range or destination filter.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Default 10."
    }
  },
  "required": [
    "language",
    "currency"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "windowDays": {
      "type": "integer"
    },
    "tours": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "airline": {
            "type": [
              "string",
              "null"
            ]
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "priceFrom": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "integer",
                    "description": "Minor units."
                  },
                  "currency": {
                    "type": "string",
                    "enum": [
                      "EUR",
                      "USD",
                      "AED"
                    ]
                  },
                  "basis": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "currency",
                  "basis"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "deepLink": {
            "type": "string"
          },
          "nextDepartureOn": {
            "type": [
              "string",
              "null"
            ]
          },
          "nightCount": {
            "type": [
              "integer",
              "null"
            ]
          },
          "departureOn": {
            "type": [
              "string",
              "null"
            ]
          },
          "daysUntilDeparture": {
            "type": [
              "integer",
              "null"
            ]
          },
          "departuresInWindow": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "slug",
          "name",
          "deepLink"
        ]
      }
    },
    "total": {
      "type": "integer"
    },
    "emptyReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "disclaimer": {
      "type": "string"
    },
    "deepLink": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "windowDays",
    "tours",
    "total",
    "emptyReason",
    "deepLink"
  ]
}
๐ŸŸขlist_hotels(language, currency, country, city, stars, ...)

Lists the curated hotel pool by country, area and stars, with facility tags. No supplier call and no price (a price needs dates and guests). city matches area words ("Antalya", "Business Bay"); the free-text argument matches name words. Each hotel carries a hotelId. When nothing matches, the reply lists nearby MBD hotels and a contact link.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ]
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ]
    },
    "country": {
      "type": "string",
      "maxLength": 100,
      "description": "Country: name in English or Turkish, or ISO 3166-1 alpha-2 code (example: \"Turkey\", \"AE\")."
    },
    "city": {
      "type": "string",
      "maxLength": 100,
      "description": "City name in Turkish or English."
    },
    "stars": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "search": {
      "type": "string",
      "maxLength": 100,
      "description": "Words in the hotel name."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "type": "string",
      "maxLength": 500,
      "description": "cursor from the previous response."
    }
  },
  "required": [
    "language",
    "currency"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "hotels": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "hotelId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "stars": {
            "type": [
              "integer",
              "null"
            ]
          },
          "segment": {
            "type": [
              "string",
              "null"
            ]
          },
          "livePricingAvailable": {
            "type": "boolean"
          },
          "highlights": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "pageUrl": {
            "type": "string"
          }
        },
        "required": [
          "hotelId",
          "name",
          "livePricingAvailable"
        ]
      }
    },
    "cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "total": {
      "type": [
        "integer",
        "null"
      ]
    },
    "emptyReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "alternativesBasis": {
      "type": "string"
    },
    "contact": {
      "type": "object"
    },
    "disclaimer": {
      "type": "string"
    },
    "deepLink": {
      "type": "string"
    },
    "deepLinkNote": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "hotels",
    "cursor",
    "deepLink"
  ]
}
๐ŸŸขquote_hotel_stay(language, currency, hotelIds, checkIn, checkOut, ...)

Gets a live supplier offer or MBD contract price (pricingSource) for hotels and dates. Books nothing and holds no room. An unverified price is not returned. PRICE_ON_REQUEST means no price is on file; the reply then carries pageUrl and contact. Supplier calls are limited daily. Needs check-in, check-out and guests. When nationality is omitted the price is for TR and the reply states nationalityUsed.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ]
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ]
    },
    "hotelIds": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "minItems": 1,
      "maxItems": 5,
      "uniqueItems": true,
      "description": "hotelId values (ids, not names)."
    },
    "checkIn": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "minLength": 10,
      "maxLength": 10,
      "description": "Check-in date; at most 365 days from today (YYYY-MM-DD)"
    },
    "checkOut": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "minLength": 10,
      "maxLength": 10,
      "description": "Check-out date; the stay must be 1-30 nights (YYYY-MM-DD)"
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6,
      "description": "Adults; at most 6 people per room, 4 children."
    },
    "childrenAges": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 17
      },
      "description": "Age of each child, one entry per child. No birth dates."
    },
    "nationality": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO 3166-1 alpha-2 code (TR, AE, DE); optional, default TR. Changes the price."
    }
  },
  "required": [
    "language",
    "currency",
    "hotelIds",
    "checkIn",
    "checkOut",
    "adults"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "quotes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "hotelId": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "available": {
            "type": "boolean"
          },
          "unavailableReason": {
            "type": "string",
            "description": "Why available is false: no room, or the supplier could not be reached now."
          },
          "stars": {
            "type": [
              "integer",
              "null"
            ]
          },
          "boardBasis": {
            "type": [
              "string",
              "null"
            ]
          },
          "roomTypes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "nights": {
            "type": "integer"
          },
          "price": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "integer",
                "description": "Minor units."
              },
              "currency": {
                "type": "string",
                "enum": [
                  "EUR",
                  "USD",
                  "AED"
                ]
              },
              "basis": {
                "type": "string"
              },
              "fxRateDate": {
                "type": "string"
              }
            },
            "required": [
              "amount",
              "currency",
              "basis"
            ]
          },
          "indicativePrice": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "integer",
                "description": "Minor units."
              },
              "currency": {
                "type": "string",
                "enum": [
                  "EUR",
                  "USD",
                  "AED"
                ]
              },
              "basis": {
                "type": "string"
              }
            },
            "required": [
              "amount",
              "currency",
              "basis"
            ]
          },
          "freeCancellationUntil": {
            "type": [
              "string",
              "null"
            ]
          },
          "cancellationKnown": {
            "type": "boolean"
          },
          "nonRefundable": {
            "type": "boolean"
          },
          "quoteExpiresAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "freshness": {
            "type": "string"
          },
          "cached": {
            "type": "boolean"
          },
          "ageMinutes": {
            "type": "integer"
          },
          "shortCache": {
            "type": "object",
            "properties": {
              "ageSeconds": {
                "type": "integer"
              }
            }
          },
          "priceSource": {
            "type": "object"
          },
          "pageUrl": {
            "type": "string"
          },
          "onRequest": {
            "type": "object"
          },
          "minNights": {
            "type": "integer"
          }
        },
        "required": [
          "hotelId",
          "available"
        ]
      }
    },
    "liveQuoteLimit": {
      "type": "object",
      "properties": {
        "reached": {
          "type": "boolean"
        },
        "resetsAt": {
          "type": "string"
        },
        "retryAfterSeconds": {
          "type": "integer"
        }
      }
    },
    "quotedAt": {
      "type": "string"
    },
    "nationalityUsed": {
      "type": "string"
    },
    "nationalityDefaulted": {
      "type": "boolean"
    },
    "nationalityNote": {
      "type": "string"
    },
    "disclaimer": {
      "type": "string"
    },
    "handoff": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string"
        },
        "label": {
          "type": "string"
        },
        "deepLink": {
          "type": "string"
        }
      }
    },
    "deepLink": {
      "type": "string"
    },
    "deepLinkNote": {
      "type": "string"
    },
    "catalogueRefreshedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "quotes",
    "quotedAt",
    "deepLink"
  ]
}
๐ŸŸขsearch_transfers(language, currency, airport, side, district, ...)

Private transfers, fixed price per vehicle. Dubai: DXB, SHJ, AUH to hotel, city transfer, full-day tour. Istanbul: IST, SAW to hotel, priced by hotel side (pass district or side). Filters: airport, serviceType, direction, side, district, passengers (a 7th passenger needs a second vehicle). Reads only: no booking.

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "airport": {
      "type": "string",
      "enum": [
        "DXB",
        "SHJ",
        "AUH",
        "IST",
        "SAW"
      ],
      "description": "Pick-up airport."
    },
    "side": {
      "type": "string",
      "enum": [
        "EUROPE",
        "ANATOLIA"
      ],
      "description": "Istanbul hotel side."
    },
    "district": {
      "type": "string",
      "description": "Istanbul hotel district, e.g. Kadikoy; sets the side."
    },
    "serviceType": {
      "type": "string",
      "enum": [
        "AIRPORT_TO_HOTEL",
        "CITY_TRANSFER",
        "FULL_DAY_PRIVATE_TOUR"
      ]
    },
    "direction": {
      "type": "string",
      "enum": [
        "ONE_WAY",
        "ROUND_TRIP",
        "TO_AIRPORT"
      ],
      "description": "Direction filter."
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Party size."
    }
  },
  "required": [
    "language",
    "currency"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "transfers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "serviceType": {
            "type": "string",
            "enum": [
              "AIRPORT_TO_HOTEL",
              "CITY_TRANSFER",
              "FULL_DAY_PRIVATE_TOUR"
            ]
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "direction": {
                  "type": "string"
                },
                "vehicleSeats": {
                  "type": "integer"
                },
                "pricePerVehicle": {
                  "type": "object",
                  "properties": {
                    "amount": {
                      "type": "integer",
                      "description": "Minor units."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "EUR",
                        "USD",
                        "AED"
                      ]
                    },
                    "basis": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "amount",
                    "currency",
                    "basis"
                  ]
                }
              },
              "required": [
                "direction",
                "vehicleSeats",
                "pricePerVehicle"
              ]
            }
          },
          "deepLink": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "serviceType",
          "options",
          "deepLink"
        ]
      }
    },
    "total": {
      "type": "integer"
    },
    "emptyReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "deepLink": {
      "type": "string"
    }
  },
  "required": [
    "transfers",
    "total",
    "emptyReason",
    "deepLink"
  ]
}
๐ŸŸขquote_transfer(language, currency, slug, direction, district, ...)

Prices one transfer for a party from the stored list price: vehicles needed (a 7th passenger needs a second), price per vehicle, total, cheapest option. Reads only: no basket, hold or order. Needs slug, direction and party size (Istanbul also needs district).

Input Schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "tr",
        "en"
      ],
      "description": "Catalogue language."
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "AED"
      ],
      "description": "Price currency."
    },
    "slug": {
      "type": "string",
      "maxLength": 200,
      "description": "Transfer slug."
    },
    "direction": {
      "type": "string",
      "enum": [
        "ONE_WAY",
        "ROUND_TRIP",
        "TO_AIRPORT"
      ],
      "description": "Listed round-trip price is used, not two one-ways."
    },
    "district": {
      "type": "string",
      "description": "Istanbul hotel district."
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Passengers."
    }
  },
  "required": [
    "language",
    "currency",
    "slug",
    "direction",
    "passengers"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "direction": {
      "type": "string"
    },
    "passengers": {
      "type": "integer"
    },
    "options": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "vehicleSeats": {
            "type": "integer"
          },
          "vehicles": {
            "type": "integer"
          },
          "pricePerVehicle": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "integer",
                "description": "Minor units."
              },
              "currency": {
                "type": "string",
                "enum": [
                  "EUR",
                  "USD",
                  "AED"
                ]
              },
              "basis": {
                "type": "string"
              }
            },
            "required": [
              "amount",
              "currency",
              "basis"
            ]
          },
          "total": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "integer",
                "description": "Minor units."
              },
              "currency": {
                "type": "string",
                "enum": [
                  "EUR",
                  "USD",
                  "AED"
                ]
              },
              "basis": {
                "type": "string"
              }
            },
            "required": [
              "amount",
              "currency",
              "basis"
            ]
          }
        },
        "required": [
          "vehicleSeats",
          "vehicles",
          "pricePerVehicle",
          "total"
        ]
      }
    },
    "cheapest": {
      "type": "object"
    },
    "validUntil": {
      "type": [
        "string",
        "null"
      ]
    },
    "deepLink": {
      "type": "string"
    }
  },
  "required": [
    "slug",
    "name",
    "direction",
    "passengers",
    "options",
    "cheapest",
    "deepLink"
  ]
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded12 tools