Tatilsepeti Hotel Search MCP Server

Model Context Protocol (MCP) server for Tatilsepeti hotel search functionality.

Features

• Search Destinations: Find regions and locations
• List Hotels: Get hotel listings with filters
• Auto Token Management: Automatically fetches fresh tokens for each request
• Rich Hotel Data: Includes prices, ratings, amenities, campaigns

Installation

Using npx (Recommended)

npx tatilsepeti-hotel-mcp

From Source

npm install
# or
yarn install

Configuration

Required Environment Variables

Create a .env file or set environment variables:

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

Or export directly:

export API_URL="https://api.tatilsepeti.com/api/v1"
export API_TOKEN="your_api_token"
export BASE_URL="https://www.tatilsepeti.com"

Usage

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tatilsepeti-hotel": {
      "command": "npx",
      "args": ["tatilsepeti-hotel-mcp"],
      "env": {
        "API_URL": "https://api.tatilsepeti.com/api/v1",
        "API_TOKEN": "your_api_token_here",
        "BASE_URL": "https://www.tatilsepeti.com"
      }
    }
  }
}

Manual Run

node mcp.js

Available Tools

1. search_destination

Search for travel destinations (regions/locations).

Parameters:

• query (string): Destination name (e.g., "antalya", "bodrum", "istanbul")

Returns:

[
  {
    "regionId": 34,
    "subRegionId": 0,
    "type": 0,
    "title": "Antalya"
  }
]

2. list_hotels

List hotels for a specific region.

Parameters:

• regionId (number): Region ID from search_destination
• subRegionId (number, optional): Sub-region ID (default: 0)
• type (number, optional): Type (default: 0)
• checkinDate (string): Check-in date (YYYY-MM-DD)
• checkoutDate (string): Check-out date (YYYY-MM-DD)
• adultCount (number, optional): Number of adults (default: 2)
• childCount (number, optional): Number of children (default: 0)
• childAges (array, optional): Ages of children (default: [])
• pageNumber (number, optional): Page number (default: 1)
• pageSize (number, optional): Hotels per page (default: 20)

Returns:

{
  "totalCount": 155,
  "currentPage": 1,
  "pageSize": 20,
  "showingCount": 20,
  "hotels": [
    {
      "name": "Hotel Name",
      "star": 5,
      "score": 8.9,
      "scoreText": "Harika",
      "reviewCount": 150,
      "location": "Kemer, Antalya",
      "price": 10500,
      "discountRate": 30,
      "accommodation": "Her Şey Dahil",
      "campaignName": "Son Dakika %30 İndirim",
      "properties": ["Aquapark", "Spa", "Denize Sıfır"],
      "isFreeCancellation": true,
      "image": "https://cdn.tatilsepeti.com/...",
      "link": "https://www.tatilsepeti.com/hotel-url"
    }
  ]
}

Example Workflow

1. Search for destination:

   User: "Antalya'da otel bul"
   → search_destination(query: "antalya")
   → Returns: regionId: 34
   

2. List hotels:

   → list_hotels(
       regionId: 34,
       checkinDate: "2025-12-24",
       checkoutDate: "2025-12-27",
       adultCount: 2
     )
   → Returns: 20 hotels with details
   

Features Included

• Static API token authentication
• Query string generation for hotel links
• Date formatting (YYYY-MM-DD → DD.MM.YYYY)
• Rich hotel details (properties, campaigns, reviews)
• Pagination support
• Environment variable configuration

Development

# Install dependencies
npm install

# Run MCP server
npm start

Architecture

┌─────────────────┐
│  Claude/Client  │
└────────┬────────┘
         │ MCP Protocol
         │
┌────────▼────────┐
│   MCP Server    │
│   (mcp.js)      │
└────────┬────────┘
         │
         │ OAuth2 + REST
         │
┌────────▼────────┐
│ Tatilsepeti API │
└─────────────────┘

License

MIT