Wisnu MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Wisnu MCP find flights from NYC to London for June 15th and suggest some hotels"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Wisnu MCP - Travel Booking Server š
A Model Context Protocol (MCP) server for travel booking operations, built with FastMCP.
Features
This MCP server provides the following tools for travel booking:
Available Tools
search_flights - Search for available flights
Origin/destination airport codes
Departure and optional return dates
Passenger count and cabin class selection
search_hotels - Search for hotels in a location
Location-based search
Check-in/check-out dates
Guest count, room requirements, and rating filters
search_destinations - Get destination recommendations
Interest-based suggestions (beach, culture, adventure, food, etc.)
Budget range filtering
Seasonal preferences
calculate_trip_cost - Estimate total trip costs
Flight and hotel cost inputs
Daily expense calculations
Per-person cost breakdown
get_travel_tips - Get travel tips for destinations
Destination-specific advice
Trip type considerations (business, leisure, adventure, family)
Installation
This project uses uv for dependency management.
Prerequisites
Python 3.13+
uv package manager
Setup
Clone or navigate to this repository:
cd wisnu-mcpThe virtual environment and dependencies are already set up. If you need to reinstall:
uv syncUsage
Running the Server
Start the MCP server with:
uv run main.pyOr if you want to run it directly with Python:
source .venv/bin/activate # On Windows: .venv\Scripts\activate
python main.pyConnecting to Claude Desktop
To use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"wisnu-travel": {
"command": "uv",
"args": [
"--directory",
"/Users/adrian/Dev/@wisatabook/wisnu-mcp",
"run",
"main.py"
]
}
}
}After updating the configuration, restart Claude Desktop.
Testing the Server
You can test individual tools by modifying main.py to call them directly:
if __name__ == "__main__":
# Test a tool
result = search_flights(
origin="JFK",
destination="LHR",
departure_date="2024-06-15",
return_date="2024-06-22",
passengers=2
)
print(result)
# Or run the server
# mcp.run()Development
Project Structure
wisnu-mcp/
āāā main.py # Main MCP server implementation
āāā pyproject.toml # Project configuration and dependencies
āāā uv.lock # Locked dependency versions
āāā README.md # This file
āāā .venv/ # Virtual environment (auto-generated)Adding New Tools
To add a new tool to the MCP server:
Define a new function in main.py
Decorate it with
@mcp.tool()Add comprehensive docstrings (they become tool descriptions)
Use type hints for all parameters
Example:
@mcp.tool()
def search_car_rentals(
location: str,
pickup_date: str,
return_date: str,
car_type: Literal["economy", "compact", "suv", "luxury"] = "economy"
) -> dict:
"""
Search for available car rentals.
Args:
location: Pickup location
pickup_date: Pickup date in YYYY-MM-DD format
return_date: Return date in YYYY-MM-DD format
car_type: Type of car needed
Returns:
Dictionary with car rental search results
"""
return {
"location": location,
"pickup_date": pickup_date,
"return_date": return_date,
"car_type": car_type,
"status": "success"
}Adding Dependencies
To add new Python packages:
uv add package-nameFor example, to add a real flight API client:
uv add amadeusNext Steps
The current implementation provides mock responses. To build a production-ready travel booking system:
Integrate Real APIs: Connect to actual flight, hotel, and destination APIs
Amadeus API for flights and hotels
Skyscanner API for comprehensive travel search
Booking.com API for accommodations
Add Resources: Use FastMCP's
@mcp.resource()decorator to expose travel dataAdd Prompts: Create
@mcp.prompt()templates for common travel queriesError Handling: Implement robust error handling for API failures
Caching: Add caching for frequently searched routes/destinations
Authentication: Add API key management for external services
Testing: Add unit and integration tests
Resources
License
MIT
Available Tools
5 toolscalculate_trip_costB
Calculate total estimated trip cost.
Args: flight_cost: Cost of flights per person hotel_cost_per_night: Hotel cost per night num_nights: Number of nights daily_expenses: Estimated daily expenses per person (default: $100) num_travelers: Number of travelers (default: 1)
Returns: Dictionary with cost breakdown
Inputs: flight_cost (required), hotel_cost_per_night (required), num_nights (required), daily_expenses, +1 more. Returns: object
get_travel_tipsC
Get travel tips and recommendations for a destination.
Args: destination: Destination city or country trip_type: Type of trip
Returns: Dictionary with travel tips
Inputs: destination (required), trip_type. Returns: object
search_destinationsB
Get destination recommendations based on interests and preferences.
Args: interests: List of interests (e.g., ["beach", "culture", "adventure", "food"]) budget_range: Budget category season: Preferred travel season
Returns: Dictionary with destination recommendations
Inputs: interests (required), budget_range, season. Returns: object
search_flightsB
Search for available flights between two locations.
Args: origin: Origin airport code (e.g., "JFK", "LAX") destination: Destination airport code (e.g., "LHR", "CDG") departure_date: Departure date in YYYY-MM-DD format return_date: Optional return date in YYYY-MM-DD format for round trips passengers: Number of passengers (default: 1) cabin_class: Cabin class preference
Returns: Dictionary with flight search results
Inputs: origin (required), destination (required), departure_date (required), return_date, +2 more. Returns: object
search_hotelsA
Search for available hotels in a location.
Args: location: City or location name (e.g., "Paris", "New York") checkin_date: Check-in date in YYYY-MM-DD format checkout_date: Check-out date in YYYY-MM-DD format guests: Number of guests (default: 1) rooms: Number of rooms needed (default: 1) min_rating: Minimum hotel rating (0-5, optional)
Returns: Dictionary with hotel search results
Inputs: location (required), checkin_date (required), checkout_date (required), guests, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: calculate_trip_cost handles cost estimation, get_travel_tips provides destination advice, search_destinations recommends places based on preferences, search_flights finds flights, and search_hotels finds accommodations. The descriptions reinforce these unique functions, making misselection unlikely.
All tool names follow a consistent verb_noun pattern with snake_case: calculate_trip_cost, get_travel_tips, search_destinations, search_flights, and search_hotels. This uniformity makes the set predictable and easy to understand, with no deviations in style or convention.
With 5 tools, this server is well-scoped for travel planning, covering key aspects like cost calculation, destination recommendations, tips, flights, and hotels. Each tool earns its place without feeling excessive or insufficient for the domain.
The tool set covers core travel planning workflows: search (destinations, flights, hotels), cost estimation, and tips. Minor gaps exist, such as no booking or reservation tools, but agents can work around this by using search results for manual follow-up, and the surface supports most agent-driven planning tasks effectively.
Related MCP Connectors
The Ferryhopper MCP server is a connector for LLMs and AI Agents in maritime travel that exposes ferry routes, schedules, and booking options. It enables AI assistants to search ports and connections across 33 countries and 190+ ferry operators, provide real-time ferry itineraries with indicative prices, and assist users with planning island-hopping or multi-leg journeys by processing natural language queries about ferry times, passenger counts, and travel durations.
The Turkish Airlines MCP server enables AI models to securely access live airline data and services, designed for developers and power users to build and test AI-driven travel solutions. It provides 13 specialized tools covering flight information (real-time status, schedules, availability), booking management (PNR details, check-in, baggage allowances), and personalized services (Miles&Smiles profiles, flight history, promotions). The server uses OAuth 2.0 authentication and is deployed on cloud-native infrastructure with enterprise-level security.
Flight search MCP server providing search, pagination, and itinerary details for AI assistants.
Skiplagged MCP Server for flight search, hotel booking, and travel planning