{
"markdown": "\n\n# π Wander Agent\n\n### Your AI's personal travel agent β flights, hotels, visas, points & miles.\n**66 tools. Zero API keys. One line to install.**\n\nAsk your AI anything about travel and get **real data back, not hallucinations** β live flight prices, the cheap fares airlines hide, real visa rules, 16-day forecasts, and credit-card points sweet spots.\n\n```bash\npip install wander-agent\n```\n\n[](https://pypi.org/project/wander-agent/) [](https://pypi.org/project/wander-agent/) [](https://github.com/VirajMishra1/wander-agent/stargazers)\n\n[](https://github.com/VirajMishra1/wander-agent/actions/workflows/ci.yml) [](https://www.python.org/) [](https://modelcontextprotocol.io/) [](https://github.com/VirajMishra1/wander-agent/blob/main/LICENSE) [](https://glama.ai/mcp/servers/VirajMishra1/wander-agent)\n\n[See the launch demo](https://x.com/virajm1shra/status/2059930318359109965) Β· **β Star this repo if it saves you a layover βοΈ**\n\n
\n\n\n\nReal run: asked for \"every way to save money on DXBβDPS for 4\" β it surfaced hidden-city, split-ticket, and nearby-airport fares for ~$8,000 group savings.\n\n
\n\n---\n\n> **Try these the second you install** β paste any of them to your AI:\n>\n> - π« *\"Find me a flight from NYC to Tokyo the airlines don't want me to see.\"* β hidden-city + split-ticket fares OTAs are banned from showing you\n> - π΄ *\"Plan a 10-day Bali trip for 2 from Dubai in September, budget $3,000.\"* β flights, hotels, visa, weather, restaurants, packing list, day-by-day β one response\n> - π *\"Which of my two passports gets me into more countries visa-free?\"* β dual-passport diff with Henley rankings\n> - π³ *\"Turn my Amex points into the best business-class flight to Europe.\"* β points sweet-spot finder across transfer partners\n\n---\n\n## What is this?\n\nWander Agent is a **tool plugin for AI assistants** (Claude, Cursor, Windsurf, etc.) that gives the AI real travel data to work with.\n\nWithout this plugin, asking an AI \"cheapest flights from New York to Tokyo in August?\" gets you a made-up answer. With this plugin, the AI calls real data sources β Google Flights, Open-Meteo, US State Dept advisories, OpenStreetMap β and gives you actual prices, real forecasts, and live visa requirements.\n\n**You talk to the AI the same way you always do. The AI does the rest.**\n\n> *\"Plan me a 10-day trip to Bali for 2 people leaving from Dubai in September, budget $3,000\"*\n> β Real flights, real hotels, visa requirements, weather forecast, local restaurants, packing list, day-by-day itinerary β all in one response.\n\n---\n\n## What can it do?\n\n\nβοΈ Flights
\n\n- Search live flights (Google Flights + Kiwi.com in parallel)\n- Find hidden-city fares β e.g. buy NYCβMexico via Houston, exit in Houston at 40% discount\n- **Split-ticket search** β book two separate tickets via a hub; OTAs are contractually forbidden from showing you this\n- **Month-level price scan** β check every month for the next year, returns cheapest month to fly\n- **Fare calendar** β cheapest day within a given month, day-of-week analysis\n- Scan for mistake fares and error pricing from deal alert sites\n- Find the cheapest destination you can fly to from anywhere\n- Find cheapest meeting point for friends flying from different cities\n- Automatically checks nearby airports (JFK also checks EWR, LGA; DXB also checks SHJ, AUH)\n\n \n\n\nπ¨ Hotels
\n\n- Search hotels with direct booking links to Booking.com, Airbnb, Expedia, Tripadvisor, and 6 more\n- Optimize for cheapest flight + hotel combo across flexible dates\n\n \n\n\nπ Visas & Entry
\n\n- Check if you need a visa, e-visa, ETA, or nothing at all\n- See every country you can enter without a full visa\n- **Passport power ranking** β Henley Index 2024 rank, visa-free %, regional breakdown\n- **Dual-passport comparison** β see exactly which destinations each passport unlocks that the other doesn't\n- **Transit visa check** β do you need a visa just to change planes? 200+ passport Γ layover rules\n- Official government apply links included\n\n \n\n\nπ€οΈ Weather
\n\n- 16-day live forecast for any location\n- Best month to visit anywhere based on 5 years of climate data\n- Jet lag calculator with science-based recovery schedule\n\n \n\n\nβ οΈ Safety
\n\n- Live US State Dept advisory level for any country (1 = safe, 4 = do not travel)\n- List every country at or above a given risk level\n- Recent travel news: strikes, airport closures, entry bans, protests\n\n \n\n\nπ° Costs
\n\n- Daily budget estimates for 220 cities (budget / mid-range / luxury)\n- Live currency conversion\n- Total trip cost estimate combining flights, hotels, and daily spend\n\n \n\n\nπΊοΈ Planning
\n\n- Day-by-day itinerary with weather and activities for each day\n- Rank and score destinations by cost + weather + safety + events\n- Compare multiple destinations side-by-side\n- Aurora viewing destinations with NOAA KP-index forecast\n- **Open-jaw trips** β fly into Rome, train to Paris, fly home from Paris. Composed automatically.\n\n \n\n\nπ Food & Nightlife
\n\n- Restaurants, bars, pubs, and cafes near any location (OpenStreetMap)\n- Cuisine filters, price level, opening hours, distance\n- Booking links: Google Maps, Zomato, TripAdvisor, Yelp, OpenTable, Resy, Untappd\n\n \n\n\nπ On the Ground
\n\n- Packing list tailored to weather, activities, and trip length\n- Language phrasebook for 17 languages with pronunciation guides\n- Layover guide for 10 major hub airports (DXB, SIN, IST, DOH, NRT, CDG, HKG, ICN, AMS, HND)\n- Health requirements: vaccines, water safety, food safety, pre-trip timeline\n- Bus, train, and ferry options with direct booking links\n- Viewpoints, beaches, hiking trails, coworking spaces near any location\n- **Local SIM guide** β 25+ countries: best prepaid SIM vs eSIM, cost, where to buy, tethering policy\n\n \n\n\nπ§ Memory & Decisions
\n\n- Saves your home airports, passports, currency, and interests β never ask again\n- Logs your trip history\n- **Saved trips** β a persistent trip with an 8-item booking checklist that survives across sessions\n- **Fare watching** β set a target price on a route, re-price on demand, get a buy signal when it drops\n- **Value ranking** β scores options 0β100 on price *plus* stops, duration, refundability, baggage and hassle (flags hidden-city / split-ticket risk), so cheapest isn't blindly \"best\"\n\n \n\n\nπ³ Credit Card Points & Miles
\n\n- **Points valuation** β is this award booking a good deal? Cents-per-point calculator with verdict (excellent / good / fair / poor) against 20+ program baselines\n- **Transfer partners** β which airlines and hotels can you transfer Chase UR / Amex MR / Citi TYP / Capital One / Bilt points to? With ratios and transfer times\n- **Points vs cash** β should you use points or pay cash? Factors in cpp value, opportunity cost, and what you'd earn back paying cash\n- **Earning calculator** β how many points does a $500 dinner earn on your Amex Gold? 9 cards modeled with bonus categories\n- **Sweet spot awards** β curated list of outsized-value redemptions: ANA first class for 120k VA miles (16.7cpp), Hyatt all-inclusive for 25k (2.4cpp), Turkish business for 45k (8.9cpp)\n- **Program comparison** β which of your points programs gives the best value for a specific booking?\n- **Card portfolio** β save your cards to your profile, points tools use them automatically\n\n \n\n---\n\n## Setup (5 minutes)\n\n### Step 1 β Install Python\n\nYou need Python 3.10 or newer. Check if you have it:\n\n```bash\npython3 --version\n```\n\nDon't have it? Download from [python.org](https://www.python.org/downloads/).\n\n---\n\n### Step 2 β Install Wander Agent\n\nFrom PyPI (recommended):\n\n```bash\npip install wander-agent\n```\n\nOr with [uv](https://docs.astral.sh/uv/) β no install at all, run directly:\n\n```bash\nuvx wander-agent\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/VirajMishra1/wander-agent.git\ncd wander-agent\npip install -e .\n```\n\nVerify it worked:\n\n```bash\nwander-agent --help\n```\n\n---\n\n### Step 3 β Connect to your AI\n\nPick the app you use:\n\n\nClaude Desktop
\n\nOpen this file in a text editor:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAdd this:\n\n```json\n{\n \"mcpServers\": {\n \"wander-agent\": {\n \"command\": \"wander-agent\"\n }\n }\n}\n```\n\nSave the file, then **quit and reopen Claude Desktop**.\n\nIf you get an error about `wander-agent` not being found, find the full path first:\n\n```bash\nwhich wander-agent\n```\n\nThen use that path in the config:\n\n```json\n{\n \"mcpServers\": {\n \"wander-agent\": {\n \"command\": \"/usr/local/bin/wander-agent\"\n }\n }\n}\n```\n\n \n\n\nClaude Code (terminal)
\n\n```bash\nclaude mcp add wander-agent wander-agent\n```\n\nConfirm it registered:\n\n```bash\nclaude mcp list\n```\n\n \n\n\nCursor
\n\nCreate or edit `.cursor/mcp.json` in your home directory:\n\n```json\n{\n \"mcpServers\": {\n \"wander-agent\": {\n \"command\": \"wander-agent\"\n }\n }\n}\n```\n\nRestart Cursor.\n\n \n\n\nWindsurf
\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"wander-agent\": {\n \"command\": \"wander-agent\"\n }\n }\n}\n```\n\nRestart Windsurf.\n\n \n\n\nCline (VS Code extension)
\n\nOpen VS Code settings, search for \"Cline MCP\", edit `cline_mcp_settings.json`:\n\n```json\n{\n \"mcpServers\": {\n \"wander-agent\": {\n \"command\": \"wander-agent\"\n }\n }\n}\n```\n\n \n\n\nContinue.dev
\n\nEdit `.continuerc.json` in your project or home directory:\n\n```json\n{\n \"mcpServers\": [\n {\n \"name\": \"wander-agent\",\n \"command\": \"wander-agent\"\n }\n ]\n}\n```\n\n \n\n\nZed
\n\nEdit `~/.config/zed/settings.json`:\n\n```json\n{\n \"context_servers\": {\n \"wander-agent\": {\n \"command\": {\n \"path\": \"wander-agent\",\n \"args\": []\n }\n }\n }\n}\n```\n\n \n\n---\n\n## Optional: API keys for better data\n\nEverything works without any API keys. These add richer data if you want:\n\n| Variable | What it unlocks | Get it free at |\n|----------|----------------|----------------|\n| `FOURSQUARE_API_KEY` | Real ratings and price levels for restaurants/bars | [foursquare.com/developers](https://foursquare.com/developers/signup) |\n| `TICKETMASTER_API_KEY` | Live event listings (concerts, sports, shows) | [developer.ticketmaster.com](https://developer.ticketmaster.com) |\n\nSet them before starting your AI:\n\n```bash\nexport FOURSQUARE_API_KEY=your_key_here\nexport TICKETMASTER_API_KEY=your_key_here\n```\n\nOr add them to your shell profile (`~/.zshrc`, `~/.bashrc`) to make them permanent.\n\n---\n\n## All 66 Tools\n\n### βοΈ Flights\n\n| Tool | What it does |\n|------|-------------|\n| `search_flights` | Live flight search across Google Flights and Kiwi.com in parallel. Returns prices, duration, stops, and booking links. |\n| `find_skiplagged_fares` | Hidden-city fares β buy a connecting flight and exit at the layover city. Often 40β60% cheaper. Carry-on only. |\n| `find_split_ticket` | Book two separate tickets through a hub instead of one through-ticket. OTAs are contractually forbidden from showing this. Savings of 20β60% on many routes. Includes full risk disclosure. |\n| `find_cheapest_month` | Scans the next 12 months by sampling the first Tuesday of each month (statistically cheapest booking day). Returns all months ranked by price with season analysis and booking links. |\n| `fare_calendar` | Full month price grid β up to 15 sampled days, day-of-week analysis, price tiers, best/worst weeks. Find the cheapest day to fly within a given month. |\n| `find_mistake_fares` | Scans Secret Flying and The Flight Deal RSS for error fares and flash deals. |\n| `cheap_anywhere_from` | Cheapest destinations from an origin across 114 airports worldwide. |\n| `find_destinations_by_budget` | Finds destinations reachable within a total budget (flights + hotels). |\n| `multi_origin_meetup` | Cheapest city for multiple friends to meet, flying from different cities. |\n| `verify_flight_route` | Confirms a direct or connecting route exists between two airports. |\n| `find_aurora_destinations` | Aurora-viewing destinations with live NOAA KP-index forecast and flight prices. |\n\n### π¨ Hotels\n\n| Tool | What it does |\n|------|-------------|\n| `search_hotels` | Hotels with booking links to Booking.com, Airbnb, Expedia, Tripadvisor, and 6 more. |\n| `optimize_budget` | Finds the cheapest flight + hotel combo across a flexible date window (Β±7 days). |\n\n### π Visas & Entry\n\n| Tool | What it does |\n|------|-------------|\n| `check_visa_requirement` | Visa category for a passport + destination pair. Returns visa-free, ETA, e-visa, visa on arrival, or visa required β with the official apply link. |\n| `visa_free_destinations` | Every country a given passport can enter without a full embassy visa. |\n| `get_passport_power` | Henley Index 2024 rank, visa-free access count, frictionless travel %, and regional breakdown for any passport. Pass two passports to get a head-to-head diff: exactly which destinations each one unlocks that the other doesn't. |\n| `check_transit_visa` | Do you need a transit visa at your layover airport? Covers 200+ passport Γ layover-country combinations. Checks LHR, JFK, DXB, SIN, FRA, IST, DOH, NRT, ICN, YYZ, SYD, and 30+ others. |\n\n### π€οΈ Weather\n\n| Tool | What it does |\n|------|-------------|\n| `get_weather` | 16-day live weather forecast for any coordinates. Falls back to 5-year historical data for dates beyond the forecast window. |\n| `best_month_to_visit` | Ranks all 12 months for a location by weather quality, based on historical climate data. |\n\n### β οΈ Safety & News\n\n| Tool | What it does |\n|------|-------------|\n| `get_travel_advisory` | US State Dept advisory level (1β4) and summary. Pulled from the live RSS feed. |\n| `list_advisories_by_level` | All countries currently at or above a given advisory level. |\n| `get_travel_news` | Scans Google News for recent disruptions: strikes, airport closures, entry bans, protests. |\n\n### π° Costs & Currency\n\n| Tool | What it does |\n|------|-------------|\n| `get_cost_of_living` | Daily budget estimates for 220 cities across budget, mid-range, and luxury tiers. |\n| `convert_currency` | Live currency conversion via European Central Bank rates. |\n| `get_exchange_rates` | Exchange rates for multiple currencies from a base currency. |\n\n### πΊοΈ Planning & Scoring\n\n| Tool | What it does |\n|------|-------------|\n| `plan_trip_package` | The main orchestrator. Calls 8+ tools in parallel and returns a complete trip: flights, hotels, visa, weather, safety, activities, ground transport, cost estimate, and booking checklist. |\n| `plan_itinerary` | Day-by-day itinerary with weather forecast and suggested activities for each day. |\n| `find_open_jaw` | Plan a fly-in/overland/fly-out trip: land in city A, travel by train or bus, fly home from city B. Composes flight + ground transport search. Shows total cost vs a round-trip to city A only. Accepts city names or IATA codes. |\n| `score_destinations` | Ranks destinations by a weighted combination of cost, weather, safety, and events. |\n| `compare_destinations` | Side-by-side comparison of 2β5 destinations for the same dates. |\n\n### π Food & Nightlife\n\n| Tool | What it does |\n|------|-------------|\n| `search_restaurants_bars` | Real venues near a location from OpenStreetMap. Returns cuisine, price level, opening hours, distance, and links to Google Maps, Zomato, TripAdvisor, Yelp, OpenTable, Resy, and Untappd. |\n\n### π Smart Trip Tools\n\n| Tool | What it does |\n|------|-------------|\n| `score_nomad_cities` | Ranks cities for remote work across 6 dimensions: cost, safety, internet speed, weather, visa ease, and lifestyle. Configurable weights. |\n| `calculate_flight_carbon` | CO2e footprint for any flight using ICAO/DEFRA 2024 factors with radiative forcing (RFI Γ1.9). Per-passenger and total emissions, Gold Standard offset cost, and train/car comparison for short routes. |\n\n### π On the Ground\n\n| Tool | What it does |\n|------|-------------|\n| `generate_packing_list` | Packing list tailored to destination weather, activities, trip length, and budget level. |\n| `find_places` | Viewpoints, beaches, hiking trails, coworking spaces, waterfalls, markets, and more from OpenStreetMap. |\n| `calculate_jet_lag` | Jet lag severity with a science-based recovery schedule: pre-departure shift, melatonin timing, light exposure strategy. |\n| `get_language_phrasebook` | Phrasebook for 17 languages with local script, romanized pronunciation, and audio tips. |\n| `get_stopover_guide` | What to do during a layover at 10 major hubs. Includes transit visa check, in-airport activities, and city excursion options. |\n| `check_travel_health` | Required and recommended vaccines, water safety, food safety, mosquito risk, altitude risk, and a pre-trip preparation timeline. Based on CDC and WHO 2024β2025 data. |\n| `search_ground_transport` | Bus, train, and ferry options with booking links. Region-aware: Amtrak and Greyhound for the US, Trainline and BlaBlaCar for Europe, IRCTC for India, 12Go for Southeast Asia. |\n| `get_local_sim_guide` | Best prepaid SIM card and eSIM for 25+ countries. Returns operator, cost, data allowance, where to buy, tethering policy, and duration-based advice (β€3 days β eSIM; longer β local SIM). Falls back to Airalo/Holafly for unlisted countries. |\n\n### ποΈ Attractions & Info\n\n| Tool | What it does |\n|------|-------------|\n| `search_activities` | Attractions near a location from Wikidata. Filter by category: museums, parks, architecture, nightlife, food, historic, nature, and more. |\n| `get_local_events` | Live events from Eventbrite: concerts, sports, festivals. |\n| `get_destination_info` | Country basics: currency, official language, timezone, dialling code, driving side. |\n| `geocode` | Converts a place name to coordinates. |\n| `verify_place` | Confirms a place actually exists (catches AI hallucinations before they reach you). |\n\n### π§ Traveler Profile\n\n| Tool | What it does |\n|------|-------------|\n| `get_traveler_profile` | Loads your saved profile: home airports, passports, currency, interests, and trip history. |\n| `onboard_traveler` | One-time setup. Saves your preferences so the AI uses them automatically in every future session. |\n| `update_traveler_profile` | Update any field, manage credit cards in your portfolio, or log a completed trip. |\n| `get_trip_history` | Your logged trip history. |\n\n### 𧳠Saved Trips (cross-session memory)\n\nPersisted to `~/.wander_agent/trips.json`. A trip carries an 8-item booking checklist (flights, hotel, visa, insurance, ground transport, advisory, packing, notify bank).\n\n| Tool | What it does |\n|------|-------------|\n| `save_trip` | Save a trip you're planning. Returns a `trip_id` and a fresh booking checklist. |\n| `list_my_trips` | List saved trips with checklist progress. Filter by status (planning/booked/completed/cancelled). |\n| `get_trip_status` | Full state + checklist progress for one trip, by id or destination. |\n| `update_trip` | Change status/dates, tick checklist items, or shortlist a flight/hotel option onto the trip. |\n| `delete_trip` | Remove a saved trip. |\n\n### π Fare Watching\n\nPersisted to `~/.wander_agent/fare_watches.json`. Records a baseline price and a price history per watched route.\n\n| Tool | What it does |\n|------|-------------|\n| `watch_fare` | Start watching a route with an optional target price. Captures a baseline on creation. |\n| `list_fare_watches` | List watches with baseline / last / lowest price seen and status. |\n| `check_fare_watches` | Re-price watched routes now. Returns buy-signal alerts: `target_hit`, `price_drop`, `price_rise`, `no_change`. |\n| `stop_fare_watch` | Pause or delete a watch. |\n\n### βοΈ Value Ranking\n\n| Tool | What it does |\n|------|-------------|\n| `rank_trip_options` | Scores a list of flight/trip options 0β100 on price plus stops, duration, refundability, baggage and hassle. Presets: cheapest / fastest / easiest / flexible / balanced. Flags hidden-city, split-ticket and self-transfer risk so the cheapest fare isn't blindly the winner. |\n\n### π³ Credit Card Points & Miles\n\nStatic dataset covering 20 loyalty programs (Chase UR, Amex MR, Citi TYP, Capital One, Bilt, 11 airlines, 4 hotel chains), 9 popular credit cards with bonus categories, and 10 curated sweet-spot awards. Card portfolio saved to `~/.wander_agent/profile.json`.\n\n| Tool | What it does |\n|------|-------------|\n| `estimate_points_value` | Is this award booking worth it? Calculates cents-per-point and compares against baseline valuations for the program. Returns excellent / good / fair / poor verdict. |\n| `find_transfer_partners` | Shows all airline and hotel transfer partners for a bank program (Chase UR β United, Hyatt, BA, etc.) with transfer ratios and times. Sorted by partner value. |\n| `calculate_points_or_cash` | Should you use points or pay cash for this booking? Factors in cpp value, opportunity cost of points, and how many points you'd earn back paying cash on a specific card. |\n| `estimate_points_earning` | How many points a purchase earns on a given card. Covers 9 cards with bonus category multipliers (3x dining, 5x travel portal, 4x supermarkets, etc.). |\n| `find_sweet_spot_awards` | Curated high-value redemptions: ANA first class via VA miles (16.7cpp), Singapore Suites (16.3cpp), Turkish business (8.9cpp), Hyatt all-inclusive (2.4cpp), and more. Filters by your programs, cabin, budget, or route. |\n| `compare_points_programs` | Which of your points programs gives the best value for a specific booking? Compares estimated points cost, portal vs transfer value, best partner, and matching sweet spots. Uses your profile cards automatically. |\n\n---\n\n## Tool Rankings: Usefulness Γ X-Factor\n\nRanked by a combination of practical impact and uniqueness β things no OTA, no chatbot, and no other travel tool does.\n\n| Rank | Tool | Why it's here |\n|------|------|---------------|\n| π₯ 1 | `find_split_ticket` | OTAs are **contractually prevented** from showing this. Book two tickets via a hub instead of a through-ticket. 20β60% savings on many long-haul routes. The travel industry's open secret. |\n| 2 | `find_skiplagged_fares` | Hidden-city ticketing. Buy a flight to city B with a layover in city A β exit in city A and never board the last leg. 40β60% off. Illegal per airline T&Cs but not against any law. Carry-on only. |\n| 3 | `plan_trip_package` | One message β complete trip. Fires 8+ tools in parallel: flights, hotels, visa, weather, safety, activities, ground transport, cost estimate. The single best demo of what this agent can do. |\n| 4 | `find_cheapest_month` | Scans 12 months, samples first Tuesday of each (statistically cheapest booking day). Returns months ranked by price with season labels. Shifting by 1β2 months = hundreds of dollars saved. |\n| 5 | `check_transit_visa` | The one nobody thinks to check until it's too late. Do you need a visa just to change planes at Heathrow? At Frankfurt? 200+ passport Γ layover combinations. Catches the trip-killer before you book. |\n| 6 | `multi_origin_meetup` | Three friends, three different cities. What's the cheapest city for all of them to meet? No OTA has a tool for this. |\n| 7 | `find_open_jaw` | Fly into Rome, take a train to Paris, fly home from Paris. No OTA lets you compose this. Automatically prices both flights + the overland segment and compares vs a simple round-trip to Rome. |\n| 8 | `get_passport_power` | Henley 2024 rank, visa-free %, regional breakdown. Dual-passport mode: exact set-diff of which destinations each passport unlocks. \"Use your Indian passport for Thailand, your US passport for Brazil.\" |\n| 9 | `score_nomad_cities` | 6-dimension scoring for digital nomad decisions: cost, safety, internet speed, weather, visa ease, lifestyle. Configurable weights. \"Score Bali vs Lisbon vs Tbilisi for 3 months, weight internet 3Γ above cost.\" |\n| 10 | `find_mistake_fares` | Error fares and airline pricing mistakes from dedicated deal aggregators. Passive discovery β \"are there any crazy cheap fares out of JFK right now?\" |\n| 11 | `fare_calendar` | Full price grid for a month. Up to 15 sampled days, cheapest day highlighted, day-of-week analysis (Tuesdays 18% cheaper on average), best/worst weeks. |\n| 12 | `cheap_anywhere_from` | \"Where can I fly cheapest from London right now?\" Scans 114 airports. Discovery tool for spontaneous travelers. |\n| 13 | `find_destinations_by_budget` | \"I have $1,500 total for 7 nights, leaving from NYC β where can I actually go?\" Returns ranked reachable destinations. |\n| 14 | `optimize_budget` | Shifts departure Β±7 days to find the cheapest flight + hotel combo. Same trip, different dates, lower price. |\n| 15 | `calculate_flight_carbon` | ICAO/DEFRA 2024 emission factors with radiative forcing (RFI Γ1.9). Per-person and total CO2e, Gold Standard offset cost at $18/tonne, train/car comparison for routes under 1,500km. |\n| 16 | `search_flights` | Core engine. Parallel Google Flights + Kiwi.com. Checks nearby airports automatically. |\n| 17 | `check_visa_requirement` | Most-asked travel question. Instant answer with official government apply link. |\n| 18 | `plan_itinerary` | Day-by-day schedule with weather per day and activity suggestions. |\n| 19 | `score_destinations` | Weighted rank: cost + weather + safety + upcoming events. \"Best place to go in September with good weather, under $150/day, safety level 1.\" |\n| 20 | `visa_free_destinations` | Full list of countries a passport can enter without a full embassy visa. |\n| 21 | `get_local_sim_guide` | 25+ countries. Best prepaid SIM vs eSIM, exact cost, where to buy, tethering, activation steps. Short trip = eSIM. Long trip = local SIM. Saves the first-hour scramble at every airport. |\n| 22 | `compare_destinations` | Side-by-side: cost, weather, safety, visa requirements, flights β for 2β5 destinations, same dates. |\n| 23 | `search_ground_transport` | Bus + train + ferry with real booking links. Region-aware. Often cheaper and more convenient than flying for routes under 500km. |\n| 24 | `check_travel_health` | Required vaccines, recommended vaccines, water safety, food safety, mosquito risk, altitude risk, pre-trip timeline. CDC + WHO 2025 data. |\n| 25 | `get_travel_advisory` | Live US State Dept level 1β4 with summary. Pulled from RSS β not cached stale data. |\n| 26 | `get_weather` | 16-day live forecast. Falls back to 5-year historical climate data for further-ahead dates. |\n| 27 | `find_aurora_destinations` | Best spots for northern lights with live NOAA KP-index forecast + flight prices from your origin. Viral for the \"bucket list\" audience. |\n| 28 | `search_hotels` | Hotel search with deep links to 9 booking sites. No prices shown directly (all hotel price APIs are paid), but all the links you need. |\n| 29 | `get_cost_of_living` | Daily budget for 220 cities: budget / mid-range / luxury tiers. |\n| 30 | `best_month_to_visit` | Climate-based ranking of all 12 months for a location. Based on 5 years of historical data. |\n| 31 | `get_stopover_guide` | What to actually do during a long layover at DXB, SIN, IST, DOH, NRT, CDG, HKG, ICN, AMS, or HND. In-airport options + city excursion feasibility. |\n| 32 | `search_activities` | Wikidata attractions by category: museums, parks, architecture, food, nightlife, historic, nature. |\n| 33 | `find_places` | OpenStreetMap viewpoints, beaches, hiking trails, coworking spaces, waterfalls, hot springs, markets. |\n| 34 | `search_restaurants_bars` | Real venues from OSM with 7 booking site links per result. Cuisine filter, price level, distance. |\n| 35 | `get_language_phrasebook` | 17 languages. Local script + romanized pronunciation + audio tips. |\n| 36 | `generate_packing_list` | Tailored to destination weather, planned activities, trip length, and budget level. |\n| 37 | `get_local_events` | Live Eventbrite events at destination: concerts, festivals, sports. Best for 0β60 day horizon. |\n| 38 | `get_travel_news` | Google News scan for disruptions: strikes, closures, protests, entry bans. |\n| 39 | `calculate_jet_lag` | Severity rating + science-based recovery: pre-trip sleep shifting, melatonin timing, light exposure schedule. |\n| 40 | `get_destination_info` | Country basics: currency, language, timezone, dialling code, driving side. |\n| 41 | `list_advisories_by_level` | All countries currently at Level 2, 3, or 4. Useful for insurance and risk-screening. |\n| 42 | `verify_flight_route` | Confirms a route actually exists. Catches hallucinated itineraries before you book. |\n| 43 | `onboard_traveler` | One-time setup: home airports, passports, currency, interests. Feeds every tool automatically. |\n| 44 | `get_traveler_profile` | Load saved profile. Used automatically at session start. |\n| 45 | `update_traveler_profile` | Update preferences or log a completed trip. |\n| 46 | `get_trip_history` | Your logged trip history. |\n| 47 | `convert_currency` | ECB live rate conversion. |\n| 48 | `get_exchange_rates` | Multi-currency rates from a base currency. |\n| 49 | `geocode` | Place name β latitude/longitude. Used internally by most tools. |\n| 50 | `verify_place` | Confirms a place exists before building a trip around it. Anti-hallucination guardrail. |\n| 51 | `find_sweet_spot_awards` | Curated outsized-value redemptions the points community swears by. ANA first (16.7cpp), Singapore Suites (16.3cpp), Turkish J (8.9cpp). Filtered by your card portfolio. |\n| 52 | `estimate_points_value` | Cents-per-point calculator with verdict against 20+ program baselines. Catches bad redemptions before you burn points. |\n| 53 | `calculate_points_or_cash` | Points or cash? Factors cpp, opportunity cost, and earning-back. The question every points traveler asks on every booking. |\n| 54 | `compare_points_programs` | Which program gives best value for this booking? Cross-program comparison with sweet-spot matching. |\n| 55 | `find_transfer_partners` | Maps bank currency β airline/hotel partners. Transfer ratios, times, and partner valuations. |\n| 56 | `estimate_points_earning` | Points earned per dollar by card and category. 9 cards modeled. |\n\n---\n\n## Data sources\n\n| Source | What it provides | Key needed? |\n|--------|----------------|-------------|\n| Google Flights (scraper) | Flight prices and airline names | No |\n| Kiwi.com | Live bookable flight prices | No |\n| Open-Meteo | Weather forecast and 5-year historical climate | No |\n| Frankfurter (ECB) | Currency exchange rates | No |\n| Wikidata SPARQL | Attractions and points of interest | No |\n| OpenStreetMap Overpass | Restaurants, bars, beaches, viewpoints, hiking | No |\n| US State Dept RSS | Travel advisories | No |\n| Open-Meteo Geocoding | Coordinates for place names | No |\n| RESTCountries | Country metadata | No |\n| Secret Flying / The Flight Deal | Mistake fares and deals | No |\n| NOAA Space Weather | Aurora KP-index forecast | No |\n| Google News RSS | Travel disruption news | No |\n| Skiplagged | Hidden-city fares | No (fragile scraper) |\n| Rome2Rio / Omio | Ground transport options | No (fallback to deeplinks) |\n| Eventbrite | Live local events | No |\n| Foursquare Places v3 | Restaurant/bar ratings and price levels | Optional (free tier) |\n| Ticketmaster Discovery | Live event listings | Optional (free tier) |\n| Static datasets | Visa requirements, cost of living, airport data, transit visa rules, SIM card data, Henley rankings, points/miles valuations | N/A |\n\n---\n\n## How much can you trust each number?\n\nMost results carry a `data_meta` block so the AI can tell you how reliable a figure is before you book:\n\n```json\n\"data_meta\": {\n \"confidence\": \"scraped_live\",\n \"trust_score\": 80,\n \"trust_label\": \"Live scrape\",\n \"meaning\": \"Scraped from Google Flights just now. Real but can shift minute to minute.\",\n \"fetched_at\": \"2026-06-02T18:30:00+00:00\",\n \"source\": \"google_flights + kiwi.com\"\n}\n```\n\n| Label | Trust | What it means |\n|-------|-------|---------------|\n| `deeplink` | 95 | Opens the live provider page β always current |\n| `live_api` | 90 | Official API (ECB rates, NOAA) |\n| `live_rss` | 85 | Live government feed (State Dept advisories) |\n| `live_forecast` | 85 | Open-Meteo live weather |\n| `scraped_live` | 80 | Real-time scrape β real but volatile |\n| `curated_snapshot` | 55 | Hand-curated dataset β verify before booking |\n| `wikidata_fallback` | 50 | Wikidata-derived |\n| `estimated` | 35 | Modeled figure β rough guide only |\n\n---\n\n## Honest limitations\n\n**Flight prices:** Google Flights scraper can break if Google changes their page structure. Kiwi prices are real and bookable. Both run in parallel β if one fails the other still returns results.\n\n**Split-ticket risk:** `find_split_ticket` surfaces real savings but carries missed-connection risk. If your first flight is delayed the second airline won't wait and won't rebook you. The tool always returns a full risk disclosure list. Buy travel insurance that covers missed connections on separate tickets.\n\n**Hotel prices:** Every hotel price API is paid. This tool returns hotel names and links to 9 booking sites where you can see real prices. No prices are shown directly.\n\n**Visa data:** Static snapshot (updated 2024). Policies change β always verify with the official link in the response before you book anything. Do not rely on this for immigration decisions.\n\n**Transit visa data:** Rules encoded as a static dataset covering 200+ combinations. Edge cases (nationalities with bilateral exemptions, recent policy changes) may be missing. Always verify with the airline or destination embassy.\n\n**Passport power data:** Henley Index 2024 snapshot. Rankings shift year to year. Confirm with official sources before making nationality-based decisions.\n\n**SIM card data:** Curated snapshot as of 2024-Q4. Prices and plans change frequently. Treat as guidance; verify before purchase.\n\n**Events:** Scraped from Eventbrite. Best coverage for events 0β60 days ahead. Further-future events may not be listed yet.\n\n**Travel advisories:** US State Dept only. Updated within 24β48 hours of official changes via RSS.\n\n**Health data:** Curated snapshot from CDC Yellow Book and WHO 2024β2025 recommendations. Not a substitute for advice from a travel medicine clinic.\n\n**Ground transport:** Rome2Rio data for route discovery. Actual prices and schedules must be confirmed on the booking sites β times and fares change.\n\n**Points/miles valuations:** Baseline cpp values are editorial averages (TPG, NerdWallet, OMAAT). Actual redemption value depends on specific award availability, transfer bonuses, and dynamic pricing. Sweet spot awards assume saver-level availability. Card bonus categories reflect terms as of 2025-Q1 β issuers change these periodically.\n\n**Carbon calculations:** ICAO/DEFRA 2024 emission factors with standard RFI multiplier (Γ1.9). Actual emissions vary by aircraft type, load factor, and routing. Use as an estimate, not an accounting figure.\n\n---\n\n## Cloud deployment (Docker)\n\nThe included `Dockerfile` and `railway.toml` let you host this server in the cloud so you can connect to it from any device β not just the computer where you installed it.\n\n**You do not need this for normal local use.** Install and run locally as described in Setup above.\n\nIf you want to self-host on [Railway](https://railway.app):\n\n```bash\n# Push to GitHub, then connect repo to Railway\n# Set env vars in Railway dashboard if using optional API keys\n```\n\nThe server switches from stdio (local) to HTTP automatically based on the `WANDER_TRANSPORT` environment variable.\n\n---\n\n## Development\n\n```bash\n# Install with dev dependencies\npip install -e \".[dev]\"\n\n# Run tests\npython -m pytest tests/ -v\n\n# Count registered tools\ngrep -c \"@mcp.tool()\" src/wander_agent/server.py\n```\n\n**Adding a tool:**\n1. Create `src/wander_agent/tools/your_tool.py` with an async function\n2. Import it in `src/wander_agent/server.py`\n3. Wrap with `@mcp.tool()` and an async wrapper function\n4. Restart your AI client to pick up the new tool\n\n**CI:** every push and PR to `main` runs the test suite on Python 3.10/3.11/3.12 and asserts the registered tool count.\n\n**Releases:** publishing a GitHub release triggers the PyPI publish workflow (trusted publishing β no tokens). Bump `version` in `pyproject.toml` and `server.json` first.\n\n---\n\n## License\n\nMIT\n\nmcp-name: io.github.VirajMishra1/wander-agent\n",
"bytes": 37747,
"sha": "3f76723e8b1fa0a89ee4267f3244dffcdb37a687fda35025916c61182ac84397",
"repo_slug": "virajmishra1/wander-agent",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_virajmishra1_wander_agent_5bb7598d/readme"
}