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
Install the MCP Remote Client
npm install -g mcp-remoteConfigure 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" ] } } }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:
Start MCP Inspector
npx @modelcontextprotocol/inspectorConfigure Connection
- Open http://localhost:5173 in your browser
- Switch Transport Type to SSE
- Enter URL: https://mcp.turkishtechlab.com/sse
- Click Connect
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:
- Email: [email protected]
🔒 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)
.png)
