Turkish Airlines Logo
— MCP

Turkish Airlines MCP Server

Welcome to the Turkish Airlines Model Context Protocol (MCP) Server! This server provides AI assistants with access to Turkish Airlines flight information, booking details, and travel services through a comprehensive set of tools.

🔐 Authentication Required: All tools require logging in with your Miles&Smiles account to access Turkish Airlines services and data.

🛫 Available Tools

✈️ Flight Information & Services

  • Search Flights - Search Turkish Airlines flights based on origin, destination, dates, and passenger details
  • Get Flight Status by Number - Fetch real-time flight status by flight number and date
  • Get Flight Status by Route - Fetch real-time flight status by route (airports and date)
  • Create Flight Booking Link - Constructs a booking deeplink for specific flight options from search results

📋 Booking & Check-in Services

  • Get Booking Details - Fetch Turkish Airlines flight booking details using PNR and surname
  • Get Check-in Booking Details - Fetch check-in booking details (works only for check-in available bookings)
  • Get Booking Baggage Allowance - Fetch detailed booking baggage information

🌍 Travel & Promotions

  • Get Airline Promotions - Fetch airline promotions by country and airports
  • Get City Guide - Fetch travel guide with promotions for specified arrival city

👤 Member Account Services

  • Get Current User Details - Fetch member's profile, miles, identity (call before other tools)
  • Get Member Flights - Fetch member's flights (should be called after getting user details)
  • Get Expiring Miles - Calculate member's expiring miles (call after getting user details)
  • Logout - Logout member from the system

🔗 Connect to the MCP Server

Using claude.ai

If you are on Pro plan, you can now integrate remote MCP servers directly.

  • Navigate to settings https://claude.ai/settings/integrations
  • Click on add integration and add use https://mcp.turkishtechlab.com/sse as integration URL
  • Complete the connection flow and you are ready.

Using Claude Desktop

  1. Install the MCP Remote Client

    npm install -g mcp-remote

  2. Configure Claude Desktop

    Open Claude Desktop settings and navigate to: Settings > Developer > Edit Config

    Add the following configuration to your claude_desktop_config.json:

    {
  "mcpServers": {
    "turkish-airlines": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.turkishtechlab.com/mcp"
      ]
    }
  }
}

  3. Restart Claude Desktop

    After saving the configuration, restart Claude Desktop. The Turkish Airlines tools will be available in the bottom-right corner of the chat interface.

Using MCP Inspector

For development and testing purposes, you can use the MCP Inspector:

  1. Start MCP Inspector

    npx @modelcontextprotocol/inspector

  2. Configure Connection

    • Open http://localhost:5173 in your browser
    • Switch Transport Type to SSE
    • Enter URL: https://mcp.turkishtechlab.com/sse
    • Click Connect

  3. Authenticate

    • You'll be redirected to the Turkish Airlines login page
    • Log in with your Miles&Smiles credentials (required for all tools)
    • Once authenticated, all tools will be available

🔧 Example Usage

Once connected and authenticated with your Miles&Smiles account, you can ask your AI assistant to help with various Turkish Airlines tasks:

Flight Information

  • "What's the status of flight TK1 on 2024-12-25?"
  • "Show me flights from Istanbul to London tomorrow"
  • "Create a booking link for flights to New York"
  • "What are the current promotions for international flights?"

Travel Planning

  • "Get me a city guide for Paris"
  • "What are the baggage allowance for my booking?"
  • "Help me find booking information for check-in"

Booking Management

  • "Get my booking details for PNR ABC123"
  • "Show me my flight booking information"

Member Services

  • "Show me my upcoming flights"
  • "What's my Miles&Smiles member information?"
  • "Check my authentication status"
  • "Show me my expiring miles"

📞 Support

For technical support or questions about the Turkish Airlines MCP Server:

🔒 Privacy & Security

  • All API calls are made directly to Turkish Airlines official endpoints
  • User credentials are handled securely through OAuth
  • No personal data is stored on our servers
  • All communications are encrypted (HTTPS/WSS)