TravelMind AI MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
✈ TravelMind AI — Real-Time Agentic Travel Planner
A multi-agent AI travel planner powered by Google Serper API (live Google search) and an MCP Server (Model Context Protocol). Four specialized agents collaborate in a pipeline to produce a complete, real-time travel plan.
🤖 Agent Architecture
User Input
│
▼
AgentOrchestrator
│
├── Phase 1 ── SearchAgent ──────────────────── Google Serper API
│ Fires 10 concurrent live searches:
│ flights · hotels · attractions · weather · visa
│ food · safety · budget · return flights · news
│
├── Phase 2 (parallel) ──────────────────────────────────────────
│ ├── PlanningAgent — synthesises search results into travel info
│ │ (visa, safety, weather, attractions, news)
│ └── BudgetAgent — extracts real prices from Serper snippets,
│ builds full cost breakdown
│
└── Phase 3 ── ItineraryAgent ──────────────────────────────────
Builds day-by-day plan from live Serper places data
AI-generated (if Gemini key) or rule-based fallbackRelated MCP server: Trip Planner MCP Server
🔌 MCP Server
The MCP server exposes all agent tools as JSON-RPC 2.0 endpoints.
Endpoint | Method | Description |
| POST | JSON-RPC 2.0 tool dispatcher |
| GET | List all 18 registered tools |
| GET | Health check & status |
| GET | SSE stream — real-time agent events |
Registered Tools (18)
Tool | Description |
| Live flight search between two cities |
| Hotels with live prices and ratings |
| Top tourist attractions at destination |
| Current and forecast weather |
| Visa requirements by nationality |
| Restaurants and dining options |
| Travel safety advisories |
| Daily cost and expense estimates |
| General Google search for any travel query |
| Targeted train fares and duration search |
| Targeted restaurant and cuisine search |
| Targeted attraction hours and ticket search |
| Targeted route travel-time search |
| Structured category budget calculation |
| Transparent caller-rate currency conversion |
| Run the full 4-agent pipeline, returns full plan |
| Day-by-day itinerary from live data |
| Detailed budget calculation |
🚀 Quick Start
1. Install
npm install2. Configure
cp .env.example .env
# Edit .env — add your Serper API key (required for live data)Get your free Serper API key at serper.dev — 2,500 free searches/month.
3. Run
# Interactive CLI planner
npm start
# MCP server only (for integrations)
npm run mcp
# Browser trip planner
# Start the MCP server, then open http://localhost:3001
# Run verification tests
npm run verify🔑 API Keys
Key | Required? | Where to get | Free tier |
| ✅ Yes | 2,500 searches/mo | |
| ❌ No | Free tier |
Without Serper: App runs in estimation mode with built-in data.
Without Gemini: Uses rule-based itinerary and snippet extraction (fully functional).
📡 MCP Server API — Example Calls
Health check
curl http://localhost:3001/mcp/healthList tools
curl http://localhost:3001/mcp/toolsCall a tool (JSON-RPC 2.0)
curl -X POST http://localhost:3001/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": "1",
"method": "tools/call",
"params": {
"name": "search_flights",
"arguments": {
"origin": "New York",
"destination": "Bangkok",
"date": "2026-11-15"
}
}
}'Plan a full trip via MCP
curl -X POST http://localhost:3001/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": "2",
"method": "tools/call",
"params": {
"name": "plan_full_trip",
"arguments": {
"origin": "London",
"destination": "Tokyo",
"startDate": "2026-12-01",
"endDate": "2026-12-10",
"numTravelers": 2,
"totalBudget": 5000,
"currency": "USD",
"budgetTier": "moderate",
"travelType": "cultural",
"nationality": "GB"
}
}
}'SSE event stream
curl -N http://localhost:3001/mcp/events📁 Project Structure
Travel_planner_agent/
├── src/
│ ├── main.js # Entry point
│ ├── agents/
│ │ ├── SearchAgent.js # Fires all Serper searches
│ │ ├── PlanningAgent.js # Synthesises search → travel info
│ │ ├── RealtimeBudgetAgent.js # Real-time price extraction & budget
│ │ ├── RealtimeItineraryAgent.js # Day-by-day plan from live places
│ │ ├── BaseAgent.js # (shared base)
│ │ ├── TransportationAgent.js # (legacy, used by fallback pipeline)
│ │ ├── AccommodationAgent.js
│ │ ├── BudgetAgent.js
│ │ ├── FoodAgent.js
│ │ └── ItineraryAgent.js
│ ├── core/
│ │ ├── AgentOrchestrator.js # Real-time 3-phase coordinator
│ │ ├── PlannerOrchestrator.js # (legacy offline orchestrator)
│ │ ├── config.js
│ │ └── constants.js
│ ├── mcp/
│ │ ├── mcpServer.js # MCP JSON-RPC 2.0 server (Express)
│ │ ├── mcpClient.js # MCP client with convenience wrappers
│ │ └── startServer.js # Standalone server entry point
│ ├── realtime/
│ │ └── serperClient.js # Google Serper API wrapper
│ ├── models/
│ │ └── TravelPlan.js # Shared data model
│ ├── ui/
│ │ ├── realtimeApp.js # Real-time app loop
│ │ ├── realtimeDisplay.js # Terminal rendering (live-aware)
│ │ ├── realtimePrompts.js # Inquirer prompts
│ │ ├── app.js # (legacy UI)
│ │ ├── display.js
│ │ └── prompts.js
│ ├── data/
│ │ ├── destinationData.js # Curated city data (fallback)
│ │ └── visaRules.js
│ └── utils/
│ ├── logger.js
│ ├── helpers.js
│ ├── openaiClient.js
│ ├── geoClient.js
│ └── weatherClient.js
├── scripts/
│ └── verify.js # End-to-end test suite
├── plans/ # Saved JSON trip plans (auto-created)
├── .env.example
├── package.json
└── README.md✅ What's Live vs Estimated
Feature | With Serper key | Without Serper key |
Flight prices | ✅ Live Google search | ⚡ Distance-based estimate |
Hotel prices & names | ✅ Live + ratings | ⚡ Tier-based estimate |
Attractions | ✅ Live places + ratings | ⚡ Built-in city data |
Weather | ✅ Live forecast | ⚡ Open-Meteo API (free) |
Visa info | ✅ Live Google search | ⚡ Local rules database |
Restaurant names | ✅ Live places | ⚡ Built-in city data |
Safety info | ✅ Live advisories | ⚡ Local curated data |
Daily cost estimates | ✅ Live cost pages | ⚡ Tier-based defaults |
Itinerary | ✅ AI+live places / rule-based+live | ⚡ Rule-based built-in |
🛠 Requirements
Node.js 18+
npm
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Travel tools for AI agents: plan and edit real trips, search stays and tours, import travel videos.
Plan and manage TravelOwl trips from ChatGPT, Claude and other MCP assistants.
Aggregated travel MCP — flights, tours, activities, price checks, visas, and more.
Personal AI travel agent. Points optimization, live flight/hotel/award search, trip planning.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides weather-aware travel planning tools that fetch 3-day forecasts and generate structured itineraries using a multi-agent orchestration system. It exposes specialized agents for weather data and trip planning to any MCP-compliant client.-
- FlicenseNot gradedqualityDmaintenanceEnables managing travel itineraries with CRUD tools for journeys, stops, and plan items, plus weather lookup, integrated with public MCP servers for time and web search.-
- AlicenseNot gradedqualityDmaintenanceCoordinates flights, hotels, events, weather, currency, and traffic data through a single MCP server, enabling comprehensive trip planning via natural language prompts.MIT
- FlicenseNot gradedqualityDmaintenanceEnables travel-related queries and planning including weather, train and flight information, itinerary generation, and travel knowledge retrieval via RAG, using an AI agent with MCP protocol.-