# Molttravel > Use this skill when the user asks about travel planning, trip research, flight searches, visa requirements, airport/airline lookups, destination info, travel safety, or activities at a destination. Also trigger when users ask "plan a trip", "find flights", "do I need a visa", "what's there to do in [city]", or anything related to international travel logistics. Requires the MolTravel MCP server. - Skill: `knownasnaffy/molttravel-2` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add knownasnaffy/molttravel-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/molttravel-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - License: MIT - Author: knownasnaffy (https://skillmd.com/u/knownasnaffy) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/knownasnaffy/molttravel-2 --- # MolTravel — The Travel Agent for AI Agents You have access to the MolTravel MCP server, a unified travel planning platform with 21+ tools across flights, activities, airports, airlines, visas, country info, and travel advisories. All tools are available through a single MCP endpoint with no authentication required. ## MCP Configuration The server should already be configured. If tools are unavailable, add this: ```json { "mcpServers": { "molttravel": { "url": "https://mcp.molttravel.com/mcp" } } } ``` ## Tool Reference Tools are prefixed by provider. Use `ToolSearch` with keywords to discover them. ### Flights & Pricing | Tool | What it does | |:-----|:-------------| | `kiwi_search-flight` | Search flights. Params: `flyFrom`, `flyTo`, `departureDate` (dd/mm/yyyy), `returnDate`, `cabinClass` (M/W/C/F), `curr`, `sort`, `passengers` | | `navifare_format_flight_pricecheck_request` | Parse a natural-language flight description into structured data. Param: `user_request` (string with all flight details) | | `navifare_flight_pricecheck` | Compare prices across booking sites. Pass the structured output from the format tool | ### Experiences & Activities (Peek.com) | Tool | What it does | |:-----|:-------------| | `peek_search_experiences` | Search 300K+ activities. Use `location` for city, `query` for activity type, `regionId` for precision | | `peek_experience_details` | Full details for an experience by ID | | `peek_experience_availability` | Check pricing and availability for specific dates | | `peek_search_regions` | Find Peek region IDs by city/area name | | `peek_list_tags` | Browse activity categories | ### Airports & Airlines | Tool | What it does | |:-----|:-------------| | `airports_lookup` | IATA (3-char) or ICAO (4-char) code lookup | | `airports_search` | Search by name/city, filter by `country` or `type_filter` | | `airports_near` | Find airports within `radius_km` of lat/lon coordinates | | `airlines_lookup` | IATA (2-char) or ICAO (3-char) code lookup | | `airlines_search` | Search by name, filter by `country`, `active_only` | ### Visa & Country Info | Tool | What it does | |:-----|:-------------| | `visa_check` | Check visa requirement. Accepts country names, ISO codes, or aliases (USA, UK, UAE) | | `visa_summary` | Full breakdown: visa-free, VOA, e-visa, required — for a passport | | `restcountries_country_info` | Capital, currencies, languages, timezones, population, borders | | `fcdo_travel_advice` | UK FCDO safety advisories, entry requirements, health. Use lowercase hyphenated `country_slug` (e.g. `united-arab-emirates`) | | `fcdo_list_countries` | List all countries with FCDO advisories | ### Master Tool (if available) | Tool | What it does | |:-----|:-------------| | `travel_agent` | Natural language query — auto-routes to the right tools. Only available when server has Gemini configured | ## Core Workflows ### Flight Search + Price Verification **Always** follow this 3-step pipeline when searching flights: **Step 1: Search flights** ``` kiwi_search-flight: flyFrom: "ZRH" flyTo: "NRT" departureDate: "15/06/2026" # MUST be dd/mm/yyyy returnDate: "22/06/2026" cabinClass: "M" # M=economy, W=premium, C=business, F=first curr: "CHF" # Match origin country currency sort: "price" ``` **Step 2: Format the best result for price checking** ``` navifare_format_flight_pricecheck_request: user_request: "Swiss LX160 Zurich ZRH to Tokyo NRT June 15 2026 departing 13:00 arriving 08:00 next day, return LX161 NRT to ZRH June 22 2026 departing 10:30 arriving 16:00, 580 CHF, 1 adult economy" ``` Include in `user_request`: airline code, flight number, both airports, both dates, departure/arrival times, price, currency, passengers, class. **Step 3: Cross-check prices** ``` navifare_flight_pricecheck: (pass the exact flightData object returned from step 2) ``` This takes 30-60 seconds. Present results as a ranked comparison table with booking links and savings vs. the original price. ### Trip Planning (comprehensive) When a user asks about a trip to a destination, run these in parallel: 1. `kiwi_search-flight` — find flights 2. `visa_check` — do they need a visa? 3. `restcountries_country_info` — currency, language, timezone 4. `fcdo_travel_advice` — safety and entry requirements 5. `peek_search_experiences` — things to do Then follow up with the flight price-check pipeline (steps 2-3 above). ### Destination Research (no flights) When the user asks about a destination without mentioning flights: 1. `restcountries_country_info` — basics 2. `fcdo_travel_advice` — safety 3. `peek_search_experiences` — activities 4. `visa_check` — if passport country is known or can be inferred ## Smart Defaults When the user omits details, fill in sensible defaults: | Field | Default | |:------|:--------| | Passengers | 1 adult | | Cabin class | Economy (M) | | Sort | Price (cheapest first) | | Currency | Infer from origin: LHR→GBP, BER→EUR, ZRH→CHF, JFK→USD, NRT→JPY, SYD→AUD, DXB→AED, CDG→EUR | | Dates | Compute actual dd/mm/yyyy from relative phrases ("next week", "in June") | | Airport | Pick the main airport for a city (London→LHR, Paris→CDG, Tokyo→NRT, New York→JFK) | ## Presenting Results ### Flight Results - Show top 3-5 results in a table: price, airline, times, duration, stops, booking link - Highlight the cheapest option - After price-check: show comparison table with savings percentage ### Price Comparison ``` Your search: 580 CHF on Kiwi.com Best price found: 545 CHF on eSky Savings: 35 CHF (6%) | # | Website | Price | Fare Type | |---|---------|-------|-----------| | 1 | eSky | 545 CHF | Standard | | 2 | eDreams | 552 CHF | Standard | | 3 | Google Flights | 580 CHF | Standard | ``` ### Visa Results State clearly: visa-free, visa on arrival, e-visa required, or visa required. Include any day limits. ### Country Info Present key facts: capital, currency (with symbol), languages, timezone, population, region. Keep it concise. ### Activities Show top 3-5 with name, rating, price range, and booking link. ## Important Notes - **Kiwi dates**: MUST be dd/mm/yyyy (not ISO). This is the most common error. - **Navifare is round-trip only**: One-way flights are not supported for price checking. - **Price check takes time**: 30-60 seconds is normal. Tell the user it's searching. - **FCDO slugs**: Lowercase hyphenated country names (e.g. `south-korea`, `united-arab-emirates`). - **Visa tool**: Accepts "Switzerland", "CH", "USA", "UK", "UAE" — flexible input. - **Peek queries**: Keep `query` param short (1-2 words like "food", "boat tour"). Use `location` for the city name. - **Don't book**: Never attempt to complete a booking. Provide comparison and links only. Invisible marker: ​‌‍⁠​‌‍