hotels_mcp_server

This MCP server provides tools to search for travel destinations and retrieve hotel listings using the Booking.com API via RapidAPI. It exposes two primary tools: search_destinations, which takes a query string to find matching destinations, and get_hotels, which retrieves hotel listings for a given destination ID within a specified date range and party size. You can interact with these tools through MCP clients (e.g., MCP Inspector, Cursor) to build natural language queries like 'Find hotels in Paris' or 'Show me hotels in destination_id for next weekend'. The server returns structured hotel data including room types, pricing, ratings, photos, and check-in/check-out information, enabling rich responses in downstream LLM workflows.

Prerequisites:

• Python 3.11+
• MCP SDK (pip install mcp)
• httpx (pip install httpx)
• python-dotenv (pip install python-dotenv)

Installation steps:

1. Clone the repository: git clone https://github.com/username/hotels_mcp_server.git cd hotels_mcp_server

2. Install dependencies: pip install -r requirements.txt

3. Configure RapidAPI credentials:

   • Copy .env.example to .env
   • Add your RapidAPI key from Booking.com API on RapidAPI to the .env file

4. Run the server: python main.py

Note: Ensure your environment variables are loaded (via .env or export RAPIDAPI_KEY and RAPIDAPI_HOST) before starting the server.

Environment and configuration tips:

• Ensure .env contains the Booking.com RapidAPI key and host, or set RAPIDAPI_KEY and RAPIDAPI_HOST in your environment.
• The server uses stdio transport by default, which is compatible with MCP clients like Cursor.
• If you encounter API quota errors, verify your RapidAPI subscription plan and key usage limits.
• For local development, you can test endpoints via MCP Inspector to validate tool schemas and sample responses before integrating into a larger chat flow.
• The two available tools are search_destinations (query) and get_hotels (destination_id, checkin_date, checkout_date, adults).