hotel

This MCP server provides hotel search capabilities for Tatilsepeti. It exposes two main tools: search_destination and list_hotels. Use search_destination to query destinations (regions or locations) by name and receive region identifiers that can be fed into subsequent requests. Then use list_hotels to fetch hotel listings for a chosen region, with options for date ranges, guest counts, and pagination. The server automatically handles token management and prepares rich hotel data, including prices, ratings, campaigns, and available amenities. When integrating with Claude Desktop or another client, you can point the client to the MCP server and pass the appropriate parameters to each tool to obtain structured results.

Prerequisites:

• Node.js and npm (or yarn) installed on your system.
• Access to the internet to install dependencies.

Install from source:

1. Clone the repository (or obtain the package)
2. Install dependencies:

npm install
# or
yarn install

Run the MCP server locally:

npm start

Alternatively, you can run via npx (recommended):

npx tatilsepeti-hotel-mcp

Environment variables (required):

• API_URL: Base URL for Tatilsepeti API (e.g., https://api.tatilsepeti.com/api/v1)
• API_TOKEN: API access token for authentication
• BASE_URL: Base website URL for link generation (e.g., https://www.tatilsepeti.com)

Example .env file:

API_URL=https://api.tatilsepeti.com/api/v1
API_TOKEN=your_api_token_here
BASE_URL=https://www.tatilsepeti.com

Tips and common considerations:

• Ensure API_TOKEN is kept secret; use a secure environment variable store in production.
• The server supports pagination (pageNumber, pageSize) for list_hotels; adjust pageSize to balance load and response size.
• If token refresh is required, the MCP will automatically fetch a fresh token per request as described in the features.
• When testing locally, verify that API_URL and BASE_URL are accessible from your environment and that CORS or network policies permit outbound requests.
• If you need to customize request parameters (e.g., different check-in/check-out dates or child ages), pass them according to the published tool interfaces (search_destination, list_hotels).