SkillAgentSearch skills...

wander-agent

Your AI's personal travel agent — 66 tools, zero API keys. Flights (incl. fares airlines hide), hotels, visas, weather, points & miles, via MCP.

Install / Use

claude mcp add VirajMishra1 -- npx -y github:VirajMishra1/wander-agent

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

76/100

Supported Platforms

Claude Code
Claude Desktop
Cursor

Our assessment of wander-agent

wander-agent scores 76/100 on our quality scale, 814th of 958 AI & Machine Learning skills we index.

Its MCP Server is 38 KB long, well organised into 38 sections with 20 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 43 days ago, so wander-agent is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

wander-agent compared with similar skills

All 4 of these similar skills score higher than wander-agent; compare them before choosing.

SkillScoreStarsUpdatedFormat
wander-agent (this skill)by VirajMishra1761043d agoMCP Server
claude-memby thedotmack100117.7ktodayCLAUDE.md
Agent-Reachby Panniantong100112.4k9d agoCLAUDE.md
Understand-Anythingby Egonex-AI10092.9k1d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md

Frequently asked questions

How do I install wander-agent?
Run claude mcp add VirajMishra1 -- npx -y github:VirajMishra1/wander-agent. The install tabs above show the steps for each supported agent.
Which AI agents does wander-agent work with?
It is written for Claude Code, Claude Desktop and Cursor, as a MCP Server file. Other agents that read the same format can often use it too.
Is wander-agent safe to use?
It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is wander-agent still maintained?
The repository was last updated 43 days ago, so wander-agent is actively maintained.
<div align="center">

🌍 Wander Agent

Your AI's personal travel agent — flights, hotels, visas, points & miles.

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

pip install wander-agent

PyPI Downloads Stars

CI Python 3.10+ MCP License: MIT wander-agent MCP server

See the launch demo · ⭐ Star this repo if it saves you a layover ✈️

<br/>

Wander Agent finding hidden-city and split-ticket fares the airlines hide

<sub><em>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.</em></sub>

</div>

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?

<details> <summary><strong>✈️ Flights</strong></summary>
  • 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)
</details> <details> <summary><strong>🏨 Hotels</strong></summary>
  • Search hotels with direct booking links to Booking.com, Airbnb, Expedia, Tripadvisor, and 6 more
  • Optimize for cheapest flight + hotel combo across flexible dates
</details> <details> <summary><strong>📋 Visas & Entry</strong></summary>
  • 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
</details> <details> <summary><strong>🌤️ Weather</strong></summary>
  • 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
</details> <details> <summary><strong>⚠️ Safety</strong></summary>
  • 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
</details> <details> <summary><strong>💰 Costs</strong></summary>
  • Daily budget estimates for 220 cities (budget / mid-range / luxury)
  • Live currency conversion
  • Total trip cost estimate combining flights, hotels, and daily spend
</details> <details> <summary><strong>🗺️ Planning</strong></summary>
  • 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.
</details> <details> <summary><strong>🍜 Food & Nightlife</strong></summary>
  • 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
</details> <details> <summary><strong>🎒 On the Ground</strong></summary>
  • 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
</details> <details> <summary><strong>🧠 Memory & Decisions</strong></summary>
  • 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"
</details> <details> <summary><strong>💳 Credit Card Points & Miles</strong></summary>
  • 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
</details>

Setup (5 minutes)

Step 1 — Install Python

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

python3 --version

Don't have it? Download from python.org.


Step 2 — Install Wander Agent

From PyPI (recommended):

pip install wander-agent

Or with uv — no install at all, run directly:

uvx wander-agent

Or from source:

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

Verify it worked:

wander-agent --help

Step 3 — Connect to your AI

Pick the app you use:

<details> <summary><strong>Claude Desktop</strong></summary>

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:

{
  "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:

which wander-agent

Then use that path in the config:

{
  "mcpServers": {
    "wander-agent": {
      "command": "/usr/local/bin/wander-agent"
    }
  }
}
</details> <details> <summary><strong>Claude Code (terminal)</strong></summary>
claude mcp add wander-agent wander-agent

Confirm it registered:

claude mcp list
</details> <details> <summary><strong>Cursor</strong></summary>

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

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

Restart Cursor.

</details> <details> <summary><strong>Windsurf</strong></summary>

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

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

Restart Windsurf.

</details> <details> <summary><strong>Cline (VS Code extension)</strong></summary>

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

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}
</details> <details> <summary><strong>Continue.dev</strong></summary>

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

{
  "mcpServers": [
    {
      "name": "wander-agent",
      "command": "wander-agent"
    }
  ]
}
</details> <details> <summary><strong>Zed</strong></summary>

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

{
  "context_servers": {
    "wander-agent": {
      "command": {
        "path": "wander-agent",
        "args": []
      }
    }
  }
}
</details>

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 | | TICKETMASTER_API_KEY | Live event listings (concerts, sports, shows) | developer.ticketmaster.com |

Set them before starting your AI:

export FOURSQUARE_API_KEY=your_key_here
export TICKETMASTER_API_KEY=your_key_here

Or add them to y

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryAI
Updated1mo ago
Forks1

Languages

Python

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info