# Wander Agent

> 60-tool AI travel agent: flights, hotels, visas, weather, fare watching, trip memory. No keys.

- **Type:** MCP server
- **Install:** `agentstack add mcp-virajmishra1-wander-agent`
- **Verified:** Pending review
- **Seller:** [VirajMishra1](https://agentstack.voostack.com/s/virajmishra1)
- **Installs:** 0
- **Latest version:** 0.1.1
- **License:** MIT
- **Upstream author:** [VirajMishra1](https://github.com/VirajMishra1)
- **Source:** https://github.com/VirajMishra1/wander-agent
- **Website:** https://pypi.org/project/wander-agent/

## Install

```sh
agentstack add mcp-virajmishra1-wander-agent
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🌍 Wander Agent

### Your AI's personal travel agent — flights, hotels, visas, points & miles.
**66 tools. Zero API keys. One line to install.**

Ask 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.

```bash
pip install wander-agent
```

[](https://pypi.org/project/wander-agent/) [](https://pypi.org/project/wander-agent/) [](https://github.com/VirajMishra1/wander-agent/stargazers)

[](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)

[See the launch demo](https://x.com/virajm1shra/status/2059930318359109965)  ·  **⭐ Star this repo if it saves you a layover ✈️**

Real 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.

---

> **Try these the second you install** — paste any of them to your AI:
>
> - 🛫 *"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
> - 🌴 *"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
> - 🛂 *"Which of my two passports gets me into more countries visa-free?"* → dual-passport diff with Henley rankings
> - 💳 *"Turn my Amex points into the best business-class flight to Europe."* → points sweet-spot finder across transfer partners

---

## What is this?

Wander Agent is a **tool plugin for AI assistants** (Claude, Cursor, Windsurf, etc.) that gives the AI real travel data to work with.

Without 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.

**You talk to the AI the same way you always do. The AI does the rest.**

> *"Plan me a 10-day trip to Bali for 2 people leaving from Dubai in September, budget $3,000"*
> → Real flights, real hotels, visa requirements, weather forecast, local restaurants, packing list, day-by-day itinerary — all in one response.

---

## What can it do?

✈️ Flights

- Search live flights (Google Flights + Kiwi.com in parallel)
- Find hidden-city fares — e.g. buy NYC→Mexico via Houston, exit in Houston at 40% discount
- **Split-ticket search** — book two separate tickets via a hub; OTAs are contractually forbidden from showing you this
- **Month-level price scan** — check every month for the next year, returns cheapest month to fly
- **Fare calendar** — cheapest day within a given month, day-of-week analysis
- Scan for mistake fares and error pricing from deal alert sites
- Find the cheapest destination you can fly to from anywhere
- Find cheapest meeting point for friends flying from different cities
- Automatically checks nearby airports (JFK also checks EWR, LGA; DXB also checks SHJ, AUH)

🏨 Hotels

- Search hotels with direct booking links to Booking.com, Airbnb, Expedia, Tripadvisor, and 6 more
- Optimize for cheapest flight + hotel combo across flexible dates

📋 Visas & Entry

- Check if you need a visa, e-visa, ETA, or nothing at all
- See every country you can enter without a full visa
- **Passport power ranking** — Henley Index 2024 rank, visa-free %, regional breakdown
- **Dual-passport comparison** — see exactly which destinations each passport unlocks that the other doesn't
- **Transit visa check** — do you need a visa just to change planes? 200+ passport × layover rules
- Official government apply links included

🌤️ Weather

- 16-day live forecast for any location
- Best month to visit anywhere based on 5 years of climate data
- Jet lag calculator with science-based recovery schedule

⚠️ Safety

- Live US State Dept advisory level for any country (1 = safe, 4 = do not travel)
- List every country at or above a given risk level
- Recent travel news: strikes, airport closures, entry bans, protests

💰 Costs

- Daily budget estimates for 220 cities (budget / mid-range / luxury)
- Live currency conversion
- Total trip cost estimate combining flights, hotels, and daily spend

🗺️ Planning

- Day-by-day itinerary with weather and activities for each day
- Rank and score destinations by cost + weather + safety + events
- Compare multiple destinations side-by-side
- Aurora viewing destinations with NOAA KP-index forecast
- **Open-jaw trips** — fly into Rome, train to Paris, fly home from Paris. Composed automatically.

🍜 Food & Nightlife

- Restaurants, bars, pubs, and cafes near any location (OpenStreetMap)
- Cuisine filters, price level, opening hours, distance
- Booking links: Google Maps, Zomato, TripAdvisor, Yelp, OpenTable, Resy, Untappd

🎒 On the Ground

- Packing list tailored to weather, activities, and trip length
- Language phrasebook for 17 languages with pronunciation guides
- Layover guide for 10 major hub airports (DXB, SIN, IST, DOH, NRT, CDG, HKG, ICN, AMS, HND)
- Health requirements: vaccines, water safety, food safety, pre-trip timeline
- Bus, train, and ferry options with direct booking links
- Viewpoints, beaches, hiking trails, coworking spaces near any location
- **Local SIM guide** — 25+ countries: best prepaid SIM vs eSIM, cost, where to buy, tethering policy

🧠 Memory & Decisions

- Saves your home airports, passports, currency, and interests — never ask again
- Logs your trip history
- **Saved trips** — a persistent trip with an 8-item booking checklist that survives across sessions
- **Fare watching** — set a target price on a route, re-price on demand, get a buy signal when it drops
- **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"

💳 Credit Card Points & Miles

- **Points valuation** — is this award booking a good deal? Cents-per-point calculator with verdict (excellent / good / fair / poor) against 20+ program baselines
- **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
- **Points vs cash** — should you use points or pay cash? Factors in cpp value, opportunity cost, and what you'd earn back paying cash
- **Earning calculator** — how many points does a $500 dinner earn on your Amex Gold? 9 cards modeled with bonus categories
- **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)
- **Program comparison** — which of your points programs gives the best value for a specific booking?
- **Card portfolio** — save your cards to your profile, points tools use them automatically

---

## Setup (5 minutes)

### Step 1 — Install Python

You need Python 3.10 or newer. Check if you have it:

```bash
python3 --version
```

Don't have it? Download from [python.org](https://www.python.org/downloads/).

---

### Step 2 — Install Wander Agent

From PyPI (recommended):

```bash
pip install wander-agent
```

Or with [uv](https://docs.astral.sh/uv/) — no install at all, run directly:

```bash
uvx wander-agent
```

Or from source:

```bash
git clone https://github.com/VirajMishra1/wander-agent.git
cd wander-agent
pip install -e .
```

Verify it worked:

```bash
wander-agent --help
```

---

### Step 3 — Connect to your AI

Pick the app you use:

Claude Desktop

Open this file in a text editor:
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add this:

```json
{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}
```

Save the file, then **quit and reopen Claude Desktop**.

If you get an error about `wander-agent` not being found, find the full path first:

```bash
which wander-agent
```

Then use that path in the config:

```json
{
  "mcpServers": {
    "wander-agent": {
      "command": "/usr/local/bin/wander-agent"
    }
  }
}
```

Claude Code (terminal)

```bash
claude mcp add wander-agent wander-agent
```

Confirm it registered:

```bash
claude mcp list
```

Cursor

Create or edit `.cursor/mcp.json` in your home directory:

```json
{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}
```

Restart Cursor.

Windsurf

Edit `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}
```

Restart Windsurf.

Cline (VS Code extension)

Open VS Code settings, search for "Cline MCP", edit `cline_mcp_settings.json`:

```json
{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}
```

Continue.dev

Edit `.continuerc.json` in your project or home directory:

```json
{
  "mcpServers": [
    {
      "name": "wander-agent",
      "command": "wander-agent"
    }
  ]
}
```

Zed

Edit `~/.config/zed/settings.json`:

```json
{
  "context_servers": {
    "wander-agent": {
      "command": {
        "path": "wander-agent",
        "args": []
      }
    }
  }
}
```

---

## Optional: API keys for better data

Everything works without any API keys. These add richer data if you want:

| Variable | What it unlocks | Get it free at |
|----------|----------------|----------------|
| `FOURSQUARE_API_KEY` | Real ratings and price levels for restaurants/bars | [foursquare.com/developers](https://foursquare.com/developers/signup) |
| `TICKETMASTER_API_KEY` | Live event listings (concerts, sports, shows) | [developer.ticketmaster.com](https://developer.ticketmaster.com) |

Set them before starting your AI:

```bash
export FOURSQUARE_API_KEY=your_key_here
export TICKETMASTER_API_KEY=your_key_here
```

Or add them to your shell profile (`~/.zshrc`, `~/.bashrc`) to make them permanent.

---

## All 66 Tools

### ✈️ Flights

| Tool | What it does |
|------|-------------|
| `search_flights` | Live flight search across Google Flights and Kiwi.com in parallel. Returns prices, duration, stops, and booking links. |
| `find_skiplagged_fares` | Hidden-city fares — buy a connecting flight and exit at the layover city. Often 40–60% cheaper. Carry-on only. |
| `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. |
| `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. |
| `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. |
| `find_mistake_fares` | Scans Secret Flying and The Flight Deal RSS for error fares and flash deals. |
| `cheap_anywhere_from` | Cheapest destinations from an origin across 114 airports worldwide. |
| `find_destinations_by_budget` | Finds destinations reachable within a total budget (flights + hotels). |
| `multi_origin_meetup` | Cheapest city for multiple friends to meet, flying from different cities. |
| `verify_flight_route` | Confirms a direct or connecting route exists between two airports. |
| `find_aurora_destinations` | Aurora-viewing destinations with live NOAA KP-index forecast and flight prices. |

### 🏨 Hotels

| Tool | What it does |
|------|-------------|
| `search_hotels` | Hotels with booking links to Booking.com, Airbnb, Expedia, Tripadvisor, and 6 more. |
| `optimize_budget` | Finds the cheapest flight + hotel combo across a flexible date window (±7 days). |

### 📋 Visas & Entry

| Tool | What it does |
|------|-------------|
| `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. |
| `visa_free_destinations` | Every country a given passport can enter without a full embassy visa. |
| `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. |
| `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. |

### 🌤️ Weather

| Tool | What it does |
|------|-------------|
| `get_weather` | 16-day live weather forecast for any coordinates. Falls back to 5-year historical data for dates beyond the forecast window. |
| `best_month_to_visit` | Ranks all 12 months for a location by weather quality, based on historical climate data. |

### ⚠️ Safety & News

| Tool | What it does |
|------|-------------|
| `get_travel_advisory` | US State Dept advisory level (1–4) and summary. Pulled from the live RSS feed. |
| `list_advisories_by_level` | All countries currently at or above a given advisory level. |
| `get_travel_news` | Scans Google News for recent disruptions: strikes, airport closures, entry bans, protests. |

### 💰 Costs & Currency

| Tool | What it does |
|------|-------------|
| `get_cost_of_living` | Daily budget estimates for 220 cities across budget, mid-range, and luxury tiers. |
| `convert_currency` | Live currency conversion via European Central Bank rates. |
| `get_exchange_rates` | Exchange rates for multiple currencies from a base currency. |

### 🗺️ Planning & Scoring

| Tool | What it does |
|------|-------------|
| `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. |
| `plan_itinerary` | Day-by-day itinerary with weather forecast and suggested activities for each day. |
| `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. |
| `score_destinations` | Ranks destinations by a weighted combination of cost, weather, safety, and events. |
| `compare_destinations` | Side-by-side comparison of 2–5 destinations for the same dates. |

### 🍜 Food & Nightlife

| Tool | What it does |
|------|-------------|
| `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. |

### 🌐 Smart Trip Tools

| Tool | What it does |
|------|-------------|
| `score_nomad_cities` | Ranks cities for remote work across 6 dimensions: cost, safety, internet speed, weather, visa ease, and lifestyle. Configurable weights. |
| `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. |

### 🎒 On the Ground

| Tool | What it does |
|------|-------------|
| `generate_packing_list` | Packing list tailored to destination weather, activities, trip length, and budget level. |
| `find_places` | Viewpoints, beaches, hiking trails, coworking spaces, waterfalls, markets, and more from OpenStreetMap. |
| `calculate_jet_lag` | Jet lag severity with a science-based recovery schedule: pre-departure shift, mel

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [VirajMishra1](https://github.com/VirajMishra1)
- **Source:** [VirajMishra1/wander-agent](https://github.com/VirajMishra1/wander-agent)
- **License:** MIT
- **Homepage:** https://pypi.org/project/wander-agent/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **0.1.1** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-virajmishra1-wander-agent
- Seller: https://agentstack.voostack.com/s/virajmishra1
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.