Trip Planner MCP

# Trip Recommendations Tool - Quick Reference ## 🚀 Quick Start ### 1. Setup (One-time) ```bash # Get API key from https://openweathermap.org/api (FREE) # Add to .env file: OPENWEATHER_API_KEY=your_key_here ``` ### 2. Test It ```bash python test_trip_recommendations.py ``` --- ## 📋 Parameters | Parameter | Required? | Type | Example | |-----------|-----------|------|---------| | `location` | ✅ Yes | string | "Paris" | | `start_date` | No | string | "2025-12-20" | | `end_date` | No | string | "2025-12-25" | | `num_people` | No | int | 4 | | `preferences` | No | string | "adventure, food" | | `budget_per_person` | No | float | 5000 | --- ## 🎯 Preferences Choose from: - `adventure` → Hiking, sports, outdoor - `nature` → Parks, wildlife, trails - `food` → Restaurants, street food, markets - `culture` → Museums, history, tours - `sightseeing` → Attractions, landmarks - `relaxation` → Spas, beaches, downtime - `shopping` → Markets, malls, souvenirs **Mix & match**: "adventure, food, culture" --- ## 💬 Example Queries ### Basic ``` "Plan a trip to Paris" ``` ### With Dates ``` "Plan a trip to Mumbai from Jan 15 to Jan 20" ``` ### With Preferences ``` "Plan a weekend trip to Goa for 4 people who love adventure and food" ``` ### Detailed ``` "Plan a 5-day trip to Udaipur from Dec 20 to Dec 25 for 4 people with preferences: adventure, nature, food. Budget is 5000 per person" ``` ### Team Trip ``` "Get my team members and plan a 3-day trip to Jaipur considering everyone's food preferences" ``` --- ## 📤 Output Includes ✅ Trip details (dates, duration, people, budget) ✅ Real-time weather forecast (24 hours) ✅ Category-based recommendations ✅ Smart tips (weather, budget, group) ✅ External resource links (TripAdvisor, Google Maps, Booking.com) --- ## ❌ Troubleshooting ### "Weather data unavailable" → Add `OPENWEATHER_API_KEY` to `.env` file ### "Could not find location" → Try "City, Country" format (e.g., "Paris, France") ### Rate limit exceeded → Wait 24 hours (free tier: 1000 calls/day) --- ## 📖 Full Documentation - **Detailed Guide**: `TRIP_RECOMMENDATIONS_GUIDE.md` - **Setup**: `README.md` - **Changes**: `ENHANCEMENT_SUMMARY.md` --- ## 🔥 Pro Tips 1. **Be specific**: More details = better recommendations 2. **Use dates**: Get accurate weather forecasts 3. **List preferences**: Comma-separated works best 4. **Group size matters**: Affects tips and suggestions 5. **Check weather first**: Plan activities around forecast 6. **Use external links**: Click through for details --- **Free API Key**: https://openweathermap.org/api (1000 calls/day)