travel_mcp
Provides access to Google Reviews for places and hotels, including review scores, star distributions, and traveler feedback.
Enables hotel search, cross-platform price comparison, room grid inspection, and property details from Hotels.com.
Offers multi-modal transit directions (walking, public transit, taxi) and place reviews from Kakao Maps.
Provides Japanese restaurant search with ratings and awards, detailed profiles, live reservation availability, and reviews from Tabelog.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@travel_mcp Compare hotel prices in Kyoto for next weekend"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Comprehensive Travel & Hospitality MCP Server (hotel_search)
A unified FastMCP server providing parallel hotel accommodations, gourmet dining and cafe searches (Tabelog Japan), multi-modal transit & routing, and verified traveler/diner reviews across global and regional platforms.
Key Capabilities
π¨ Accommodations & Hotels
π Parallel Multi-Provider Search: Query Agoda, Booking.com, and Hotels.com simultaneously with
search_hotels(..., provider="all").π Silent Chrome Authentication: Seamlessly loads user sessions for Agoda (VIP tier), Booking.com (Genius tier), and Hotels.com (OneKey rewards).
βοΈ Cross-Platform Price Comparison: Compare live rates across all three platforms in parallel using
compare_hotel_prices(...)to find the cheapest provider.ποΈ Room Grid & Rate Packages: Inspect bed configurations, room sizes, breakfast inclusions, cancellation policies, and rates.
π½οΈ Dining, Restaurants & Cafes (Tabelog Japan)
π£ Gourmet Search & Ranking: Search restaurants with Bayesian score curves (
>=3.50top 3%,>=4.00legendary/Michelin tier) viasearch_restaurants(...)/search_tabelog(...).π Award Winner Highlights: Filter and highlight The Tabelog Award winners (Gold, Silver, Bronze) and Tabelog 100 Famous Stores (Hyakumeiten).
π± Budget & Amenities: Separate lunch vs. dinner budgets, multilingual menus, private dining rooms, and barrier-free access.
π Live Vacancy Calendar: Check open reservation dates via
check_restaurant_reservation(...).
π§ Multi-Modal Transit & Navigation
πΆππ Directions & Fares: Calculate walking routes, public transit (subway/bus line names and transfers), and taxi fares via
get_transit_and_directions(...).
β Verified Place Reviews
π¬ Cross-Platform Reviews: Retrieve review scores, star distributions, and traveler feedback from Google Reviews, Kakao Maps, and Tabelog via
get_place_reviews(...).
Related MCP server: MCP Travel Concierge Server
Project Structure
hotels-mcp/
βββ pyproject.toml # PEP 517/518 build config, dependencies & CLI entrypoints
βββ README.md # Documentation & usage guide
βββ AGENTS.md # Agent guidelines & GitNexus code intelligence
βββ CLAUDE.md # Claude developer instructions
βββ tests/
β βββ __init__.py
β βββ test_server.py # 17 live multi-provider integration test suites
βββ src/
βββ travel_mcp/
βββ __init__.py # Package root
βββ __main__.py # CLI entrypoint (`python -m travel_mcp`)
βββ server.py # FastMCP server instance, tools, prompts & resources
βββ models.py # Normalized Pydantic DTOs for travel, dining, and transit
βββ providers/
βββ __init__.py # Unified provider factory & registry
βββ accommodations/ # Hotel accommodation providers
β βββ __init__.py
β βββ base.py # HotelProvider ABC & session loader
β βββ agoda.py # Agoda accommodation provider
β βββ booking.py # Booking.com accommodation provider
β βββ hotels_com.py # Hotels.com accommodation provider
βββ dining/ # Restaurant & cafe providers
β βββ __init__.py # Dining provider factory
β βββ base.py # DiningProvider ABC
β βββ tabelog.py # Tabelog client & vacancy parser
βββ routes/ # Multi-modal routing providers
β βββ __init__.py # Route provider factory
β βββ base.py # RouteProvider ABC
β βββ kakao.py # Kakao Maps routing provider
βββ reviews/ # Unified place review providers
βββ __init__.py # Review provider registry
βββ base.py # ReviewProvider ABC
βββ agoda.py # Agoda reviews provider
βββ google.py # Google Reviews provider
βββ kakao.py # Kakao Place reviews provider
βββ tabelog.py # Tabelog reviews providerInstallation & Setup
cd /Users/richardluo/Developer/hotels-mcp
uv syncRun Tests:
uv run python tests/test_server.pyRun Server:
uv run travel-mcp
# or
uv run python -m travel_mcpAntigravity / MCP Configuration
Add to ~/.gemini/config/mcp_config.json or your workspace .agents/mcp_config.json:
{
"mcpServers": {
"travel_mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/richardluo/Developer/hotels-mcp",
"run",
"python",
"-m",
"travel_mcp"
],
"env": {
"PYTHONUNBUFFERED": "1"
}
}
}
}Available Tools
π½οΈ Dining, Restaurants & Cafes
Tool | Parameters | Description |
|
| Searches top-rated restaurants across Japan on Tabelog (tabelog.com). Includes Bayesian scores (3.5+ top 3%, 4.0+ legendary), Award winners (Gold/Silver/Bronze), Hyakumeiten (100 Famous Stores), lunch/dinner budgets, and booking status. |
|
| Fetches complete restaurant profile, award history, exact address, GPS coordinates, phone, budget, amenities, and high-res food photos. |
|
| Autocompletes search keywords for restaurants, stations, areas, and food genres. |
|
| Checks live upcoming online booking vacancy calendar and available reservation dates for a restaurant. |
| (same as search_restaurants) | Direct shortcut to Tabelog restaurant search. |
| (same as get_restaurant_details) | Direct shortcut to Tabelog restaurant profile. |
| (same as suggest_dining) | Direct shortcut to Tabelog autocomplete. |
| (same as check_restaurant_reservation) | Direct shortcut to Tabelog vacancy calendar. |
π§ Multi-Modal Transit & Routing
Tool | Parameters | Description |
|
| Calculates walking steps, public transit (subway/bus lines, transfers, fares), and driving taxi fares between any two places (hotels, restaurants, cafes, stations, airports). |
|
| Alias for |
β Place & Venue Reviews
Tool | Parameters | Description |
|
| Fetches verified user reviews, star distributions, and reviewer feedback from Kakao Maps, Google Reviews ( |
π¨ Accommodations & Hotels
Tool | Parameters | Description |
|
| Searches Agoda, Booking.com, and/or Hotels.com in parallel with date, occupancy, and price filters. |
|
| Runs a 3-way parallel price check across Agoda, Booking.com, and Hotels.com to find the cheapest rate. |
|
| Autocompletes destination cities, districts, landmarks, and properties across Agoda, Booking.com, and Hotels.com. |
|
| Fetches property overview, address, amenities, and policies. |
|
| Inspects room types, bed setups, breakfast inclusion, cancellation policies, and rates. |
|
| Fetches verified traveler reviews and category scores. |
|
| Retrieves official verified hotel FAQs. |
|
| Checks active authentication for Agoda (VIP), Booking.com (Genius), and Hotels.com (OneKey). |
|
| Opens Chrome to sign-in portal if session expired (supports |
MCP Prompts & Resources (MCP 2.0)
Prompts
plan_trip_itinerary(destination, check_in, check_out, adults, dining_preferences): End-to-end trip planning combining hotels, dining recommendations, and transit routes.search_japan_dining(query, prefecture, genre, meal_type): Discover top-rated dining spots and award winners in Japan.compare_hotel_deals(hotel_name, check_in, check_out, adults, rooms): 3-way price comparison and perk evaluation.search_destination_hotels(destination, check_in, check_out, adults, rooms): Search and rank accommodations.
Resources
travel://providers(andhotels://providers): Registry of accommodation, dining, routing, and review providers.travel://capabilities: Full capability breakdown across all travel domains.travel://status(andhotels://status): Live session & cookie health across all providers.
Available Tools
20 toolscheck_restaurant_reservationBRead-onlyIdempotent
Check live upcoming online booking vacancy calendar and available reservation dates for a restaurant.
Inputs: restaurant_id (required), provider. Returns: object
check_tabelog_reservationARead-onlyIdempotent
Direct shortcut to check upcoming reservation availability on Tabelog Japan.
Equivalent to check_restaurant_reservation(restaurant_id, provider='tabelog').
Inputs: restaurant_id (required). Returns: object
compare_hotel_pricesARead-onlyIdempotent
Perform a cross-platform parallel price check across all providers to find the absolute cheapest booking rate.
Queries Agoda, Booking.com, and Hotels.com simultaneously for the specified hotel, extracts lowest available nightly rates, perks, and direct URLs, and highlights the winning platform.
Inputs: check_in (required), check_out (required), hotel_name (required), rooms, +1 more. Returns: Cross-provider price comparison result identifying the cheapest booking option.
get_hotel_distance_and_transitBRead-onlyIdempotent
Calculate travel distance and transit options between a hotel and a target destination.
Alias of get_transit_and_directions(...).
Inputs: origin (required), destination (required), country, provider, +1 more. Returns: Multi-modal distance and route analysis between origin and destination.
get_hotel_faqBRead-onlyIdempotent
Fetch verified property FAQs regarding check-in policies, parking, breakfast, airport shuttle, and deposits.
Inputs: hotel_id (required), provider. Returns: result
get_hotel_reviewsBRead-onlyIdempotent
Fetch verified traveler reviews, category ratings (cleanliness, location, service), and review comments.
Inputs: hotel_id (required), page, provider, page_size. Returns: object
get_login_statusARead-onlyIdempotent
Check current authentication and VIP/Member reward status on hotel platforms.
Inspects active session cookies loaded from Chrome for Agoda (VIP tiers, cashbacks), Booking.com (Genius membership), and Hotels.com (OneKey rewards).
Inputs: provider. Returns: object
get_place_reviewsARead-onlyIdempotent
Fetch verified local user reviews, star ratings, category strengths (cleanliness, price, location), and reviewer photos from dedicated review platforms (Kakao Maps, Google Reviews, Tabelog Japan, etc.).
Accepts hotel/place name, platform place ID (e.g. '2040574326', '13294162'), or review URL (e.g. 'https://place.map.kakao.com/2040574326#review', 'https://tabelog.com/en/tokyo/A1301/A130103/13294162/').
Inputs: place_or_hotel (required), page, provider, page_size. Returns: Normalized review summary and aggregate ratings for a hotel or place.
get_property_detailsBRead-onlyIdempotent
Get full property overview, address, star classification, amenities, and room rate options.
Inputs: hotel_id (required), rooms, adults, check_in, +4 more. Returns: object
get_restaurant_detailsBRead-onlyIdempotent
Fetch full restaurant & cafe profile, award history, address, coordinates, budget, and amenities.
Inputs: restaurant_id_or_url (required), provider. Returns: Detailed restaurant profile from Tabelog.
get_room_gridBRead-onlyIdempotent
Inspect detailed room grid, bed setups, room dimensions, breakfast inclusion, and cancellation terms.
Inputs: hotel_id (required), rooms, adults, check_in, +4 more. Returns: object
get_tabelog_restaurant_detailsARead-onlyIdempotent
Direct shortcut to fetch full Tabelog restaurant profile, address, coordinates, budget, and amenities.
Equivalent to get_restaurant_details(restaurant_id_or_url, provider='tabelog').
Inputs: restaurant_id_or_url (required). Returns: Detailed restaurant profile from Tabelog.
get_transit_and_directionsARead-onlyIdempotent
Calculate travel routes, turn-by-turn walking steps, public transit (subway/bus), and driving taxi fares between ANY two travel entities (hotels, restaurants, cafes, stations, airports, landmarks).
Supports automatic English & local language place name resolution (e.g., 'Sotetsu Hotels The Splaisir Seoul Myeongdong' -> 'N Seoul Tower', 'Incheon Airport T1' -> 'Myeongdong Station').
Inputs: origin (required), destination (required), country, provider, +1 more. Returns: Multi-modal distance and route analysis between origin and destination.
interactive_loginA
Launch Chrome browser to sign in to a hotel booking provider.
Opens the official authentication portal for the requested provider (Agoda, Booking.com, or Hotels.com) so the user can complete login and capture member rates.
Inputs: provider. Returns: object
search_hotelsARead-onlyIdempotent
Search hotels across Agoda, Booking.com, and Hotels.com in parallel.
Retrieves live property rates, room categories, review scores, discounts, and booking links. Preserves rich platform-specific data such as room sizes (mΒ²/ftΒ²), crossed-out original prices, included perks (free cancellation, breakfast), and star ratings.
Inputs: query (required), check_in (required), check_out (required), limit, +7 more. Returns: object
search_restaurantsARead-onlyIdempotent
Search top-rated restaurants, cafes, and gourmet dining spots (via Tabelog Japan and global dining providers).
Includes verified Bayesian rating scores (>=3.50 is top ~3% in Japan, >=4.00 is legendary Michelin tier), The Tabelog Award winners (Gold, Silver, Bronze), 100 Famous Stores (Hyakumeiten), lunch vs. dinner budgets, multilingual menu indicators, and direct online reservation status.
Inputs: query (required), area, page, genre, +5 more. Returns: Search response containing matching restaurants on Tabelog.
search_tabelogARead-onlyIdempotent
Direct shortcut to search restaurants across Japan on Tabelog (tabelog.com).
Equivalent to search_restaurants(..., provider='tabelog').
Inputs: query (required), area, page, genre, +4 more. Returns: Search response containing matching restaurants on Tabelog.
suggest_diningARead-onlyIdempotent
Autocomplete search query for restaurants, cafes, stations, areas, and food genres.
Inputs: query (required), limit, provider. Returns: result
suggest_locationsARead-onlyIdempotent
Autocomplete search query for destinations, cities, districts, landmarks, and properties.
Queries platform typeahead endpoints in parallel to resolve destination IDs, geo-coordinates, and candidate property identifiers.
Inputs: query (required), limit, provider. Returns: object
suggest_tabelogARead-onlyIdempotent
Direct shortcut to autocomplete keywords on Tabelog Japan.
Equivalent to suggest_dining(query, provider='tabelog', limit=limit).
Inputs: query (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 20 tools
Several tools are direct aliases (e.g., search_restaurants vs search_tabelog, get_restaurant_details vs get_tabelog_restaurant_details, suggest_dining vs suggest_tabelog, check_restaurant_reservation vs check_tabelog_reservation, get_transit_and_directions vs get_hotel_distance_and_transit) that create redundancy and potential misselection. Though descriptions clarify they are equivalent, the presence of both forms is confusing.
Naming is inconsistent: most tools follow a verb_noun pattern (get_, search_, suggest_), but deviations like 'search_tabelog', 'get_tabelog_restaurant_details', and 'get_hotel_distance_and_transit' break the pattern. Tools with provider-specific shortcuts don't align with the general naming convention, making the set feel ad hoc.
At 20 tools, the server borders on heavy. The count is inflated by multiple alias/shortcut tools that duplicate existing functionality (e.g., search_restaurants vs search_tabelog). The effective unique tool count is lower, but the redundancy suggests the set could be streamlined.
The server covers discovery and research well: hotel search, price comparison, details, rooms, reviews, FAQs, restaurant search/details, reservation availability, transit, and place reviews. However, it lacks actual booking or reservation creation (only checks availability), and no itinerary management or broader travel lifecycle features, leaving notable gaps for end-to-end travel planning.
Maintenance
Related MCP Connectors
Travel & commerce intelligence for AI agents: search, book & price-track hotels, events, retail.
Search MCP servers, agent skills and APIs for travel: hotel ID mapping, rates, rooms.
Waysway AI travel MCP for hotels, live prices, restaurants, flights, and activities.
Aggregated travel MCP β flights, tours, activities, price checks, visas, and more.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables LLMs to perform travel-related tasks by interacting with Google Maps and travel planning services including location search, place details, and travel time calculations.598MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive travel planning by integrating Google Travel Services and Amadeus GDS for dual flight and hotel searches, plus event discovery, weather forecasting, currency conversion, and location services. Combines consumer-friendly search with professional travel industry data for optimal trip planning.6MIT
- AlicenseCqualityDmaintenanceEnables complex travel planning by integrating flight and hotel search via Booking.com API and Google Maps for location context.312 npm9MIT
- AlicenseAqualityBmaintenanceSearches hotels and vacation rentals with nightly and total rates, ratings, amenities, and detailed property information through natural language in any MCP client.164 npm40 PyPI2MIT