DocumentationMCPCLI

Introduction

  • Overview

Hotels

  • Search hotels
  • Hotel details
  • Live rates

Booking

  • Create booking

Account

  • Sign in
  • Sign out
  • Show account

Guides

  • Agent guide

Local MCP

  • Local MCP server

Hotels

Search hotels

Find hotels with indicative prices.

MCP: search_hotels

Usage

fortrip hotels search --check-in YYYY-MM-DD --check-out YYYY-MM-DD [options]

Options

FlagFieldDescription
-q, --query <text>queryHotel name, brand or city to search for. Provide at least one of --query, --city-code or --near.
--city-code <n>cityCodeCatalogue city code, as returned in hotels[].cityCode.
--near <lat,lng,km>nearSearch around a point, as lat,lng,radiusKm (radius up to 200), e.g. 13.75,100.5,5.
--check-in YYYY-MM-DDcheckInCheck-in date, yyyy-MM-dd.
--check-out YYYY-MM-DDcheckOutCheck-out date, yyyy-MM-dd. Stays are 1 to 15 nights.
--star-min <n>starMinLowest star rating to include.
--star-max <n>starMaxHighest star rating to include.
--facility <name>...facilitiesFacilities every hotel must have. Names must match the catalogue exactly (case-insensitive), e.g. Swimming pool, Parking.
--price-min <n>priceMinLowest average nightly price, in currency. Applied to indicative prices.
--price-max <n>priceMaxHighest average nightly price, in currency.
--sort recommended|price-asc|price-desc|star-desc|distancesortByResult order. recommended sorts by distance with near, by relevance with query, otherwise by catalogue weight. distance requires near.
--page <n>pagePage number.
--page-size <n>pageSizeHotels per page.
--currency CNY|USDcurrencyCurrency to show prices in. Prices are converted from the supplier's at Stripe's exchange rate; the response's fx says how.
--body <json|@file.json>—The raw request body as a JSON object, or @file.json to read it from a file. Flags override its fields.

Output

Prints the Search result object on stdout. Errors go to stderr with an exit code.

PreviousOverviewNextHotel details

On this page

  • Usage
  • Options
  • Output
Fortrip

Opinionated trip planning, built for real itineraries.

Plan

  • AI Trip Planner
  • Validator
  • Transport
  • Stays

Company

  • Pricing
  • About
  • Team
  • Blog
  • Decision Optimization
  • Itinerary Selection
  • News

Resources

  • Explore Destinations
  • Brand Assets
  • Responsible Travel
  • vs ChatGPT
  • Best AI travel planner
  • FAQ

© 2026 FortripAI, Inc.

PrivacyTerms
info@fortrip.ai+1-650-272-16121111b South Governors Ave, Dover, DE 19904
Skip to main content
Fortrip Logo
HomeExplorePlanningPricing
CLIMCPDocs
Saved0