Skip to main content
Glama

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.50 top 3%, >=4.00 legendary/Michelin tier) via search_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 provider

Installation & Setup

cd /Users/richardluo/Developer/hotels-mcp
uv sync

Run Tests:

uv run python tests/test_server.py

Run Server:

uv run travel-mcp
# or
uv run python -m travel_mcp

Antigravity / 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

search_restaurants

query, prefecture=None, area=None, genre=None, sort_by='rating', meal_type='all', provider='tabelog', page=1, limit=10

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.

get_restaurant_details

restaurant_id_or_url, provider='tabelog'

Fetches complete restaurant profile, award history, exact address, GPS coordinates, phone, budget, amenities, and high-res food photos.

suggest_dining

query, provider='tabelog', limit=5

Autocompletes search keywords for restaurants, stations, areas, and food genres.

check_restaurant_reservation

restaurant_id, provider='tabelog'

Checks live upcoming online booking vacancy calendar and available reservation dates for a restaurant.

search_tabelog

(same as search_restaurants)

Direct shortcut to Tabelog restaurant search.

get_tabelog_restaurant_details

(same as get_restaurant_details)

Direct shortcut to Tabelog restaurant profile.

suggest_tabelog

(same as suggest_dining)

Direct shortcut to Tabelog autocomplete.

check_tabelog_reservation

(same as check_restaurant_reservation)

Direct shortcut to Tabelog vacancy calendar.

🧭 Multi-Modal Transit & Routing

Tool

Parameters

Description

get_transit_and_directions

origin, destination, travel_mode='all', country='KR', provider=None

Calculates walking steps, public transit (subway/bus lines, transfers, fares), and driving taxi fares between any two places (hotels, restaurants, cafes, stations, airports).

get_hotel_distance_and_transit

origin, destination, travel_mode='all', country='KR', provider=None

Alias for get_transit_and_directions.

⭐ Place & Venue Reviews

Tool

Parameters

Description

get_place_reviews

place_or_hotel, provider='kakao', page=1, page_size=10

Fetches verified user reviews, star distributions, and reviewer feedback from Kakao Maps, Google Reviews (provider='google'), or Tabelog (provider='tabelog').

🏨 Accommodations & Hotels

Tool

Parameters

Description

search_hotels

query, check_in, check_out, adults=2, children=0, rooms=1, min_price=None, max_price=None, provider='all', logged_in=True, limit=10

Searches Agoda, Booking.com, and/or Hotels.com in parallel with date, occupancy, and price filters.

compare_hotel_prices

hotel_name, check_in, check_out, adults=2, rooms=1

Runs a 3-way parallel price check across Agoda, Booking.com, and Hotels.com to find the cheapest rate.

suggest_locations

query, provider='all', limit=5

Autocompletes destination cities, districts, landmarks, and properties across Agoda, Booking.com, and Hotels.com.

get_property_details

hotel_id, provider='agoda', check_in=None, check_out=None, adults=2, children=0, rooms=1, logged_in=True

Fetches property overview, address, amenities, and policies.

get_room_grid

hotel_id, provider='agoda', check_in="", check_out="", adults=2, children=0, rooms=1, logged_in=True

Inspects room types, bed setups, breakfast inclusion, cancellation policies, and rates.

get_hotel_reviews

hotel_id, provider='agoda', page=1, page_size=10

Fetches verified traveler reviews and category scores.

get_hotel_faq

hotel_id, provider='agoda'

Retrieves official verified hotel FAQs.

get_login_status

provider='all'

Checks active authentication for Agoda (VIP), Booking.com (Genius), and Hotels.com (OneKey).

interactive_login

provider='agoda'

Opens Chrome to sign-in portal if session expired (supports 'agoda', 'booking.com', or 'hotels.com').


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 (and hotels://providers): Registry of accommodation, dining, routing, and review providers.

  • travel://capabilities: Full capability breakdown across all travel domains.

  • travel://status (and hotels://status): Live session & cookie health across all providers.

Available Tools

20 tools
check_restaurant_reservationB
Read-onlyIdempotent

Check live upcoming online booking vacancy calendar and available reservation dates for a restaurant.

Inputs: restaurant_id (required), provider. Returns: object

check_tabelog_reservationA
Read-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_pricesA
Read-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_transitB
Read-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_faqB
Read-onlyIdempotent

Fetch verified property FAQs regarding check-in policies, parking, breakfast, airport shuttle, and deposits.

Inputs: hotel_id (required), provider. Returns: result

get_hotel_reviewsB
Read-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_statusA
Read-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_reviewsA
Read-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_detailsB
Read-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_detailsB
Read-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_gridB
Read-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_detailsA
Read-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_directionsA
Read-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_hotelsA
Read-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_restaurantsA
Read-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_tabelogA
Read-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_diningA
Read-onlyIdempotent

Autocomplete search query for restaurants, cafes, stations, areas, and food genres.

Inputs: query (required), limit, provider. Returns: result

suggest_locationsA
Read-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_tabelogA
Read-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

    B3.3/5.0

    Scored across 20 tools

    Disambiguation3/5

    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 Consistency2/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers