MBD Travel

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

사용해야 할까요

품질 및 안전성

A
설명 품질
98%
스키마 완전성
98%
이름 품질
93%
오염 위험
80%
권한 일치
80%
프로토콜 준수
100%

발견 사항 (5)

  • HIGHTool poisoning patterns detected
  • LOWTool 'compare_tours' description lacks action verbcompare_tours에서
  • LOWTool description contains role marker that could confuse chat modelssearch_transfers에서
  • LOWTool 'fetch' suggests web access but openWorldHint=falsefetch에서
  • LOWTool 'browse_destinations' suggests web access but openWorldHint=falsebrowse_destinations에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~6,232토큰 (도구 정의)
~4.8 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 4.87%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (12)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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.

입력 스키마

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

출력 스키마

{
  "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).

입력 스키마

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

출력 스키마

{
  "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"
  ]
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 12개