How do I use TravelMind AI MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@TravelMind AI MCP Server Plan a 5-day trip to Tokyo from San Francisco with a $2000 budget." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

TravelMind AI MCP Server

by ganeshakhila6

Overview Schema Source Related Servers Score Discussions Admin

JavaScript

Local

✈ 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 fallback

Related MCP server: trip-planner-mcp

🔌 MCP Server

The MCP server exposes all agent tools as JSON-RPC 2.0 endpoints.

Endpoint	Method	Description
`/mcp`	POST	JSON-RPC 2.0 tool dispatcher
`/mcp/tools`	GET	List all 18 registered tools
`/mcp/health`	GET	Health check & status
`/mcp/events`	GET	SSE stream — real-time agent events

Registered Tools (18)

Tool	Description
`search_flights`	Live flight search between two cities
`search_hotels`	Hotels with live prices and ratings
`search_attractions`	Top tourist attractions at destination
`search_weather`	Current and forecast weather
`search_visa`	Visa requirements by nationality
`search_food`	Restaurants and dining options
`search_safety`	Travel safety advisories
`search_budget`	Daily cost and expense estimates
`general_search`	General Google search for any travel query
`search_trains`	Targeted train fares and duration search
`search_restaurants`	Targeted restaurant and cuisine search
`get_opening_hours`	Targeted attraction hours and ticket search
`get_travel_time`	Targeted route travel-time search
`calculate_budget`	Structured category budget calculation
`convert_currency`	Transparent caller-rate currency conversion
`plan_full_trip`	Run the full 4-agent pipeline, returns full plan
`get_itinerary`	Day-by-day itinerary from live data
`get_budget_breakdown`	Detailed budget calculation

🚀 Quick Start

1. Install

npm install

2. 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
`SERPER_API_KEY`	✅ Yes	serper.dev	2,500 searches/mo
`GEMINI_API_KEY`	❌ No	Google AI Studio	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/health

List tools

curl http://localhost:3001/mcp/tools

Call 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

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Dreamfare A
app.dreamfare
Travel tools for AI agents: plan and edit real trips, search stays and tours, import travel videos.
Travel & Transportation Location Services
441
MolTravel B
com.moltravel
Aggregated travel MCP — flights, tours, activities, price checks, visas, and more.
Travel & Transportation Search App Automation
562
Journi TravelOAuth
io.github.ama353-arch
Personal AI travel agent. Points optimization, live flight/hotel/award search, trip planning.
Travel & Transportation Search
2
Flight MCP
com.flight-mcp
Search and compare flight offers through a cache-aware Streamable HTTP MCP server for AI agents.
Travel & Transportation Search
1

Related MCP Servers

Travel Planner MCP Server
Travel & Transportation Agent Orchestration Weather Services
DasBalvinderDas
F
license
Not graded
quality
D
maintenance
Provides 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.
Updated 7 months ago (2026-02-11 11:27 UTC)
-
trip-planner-mcp
Travel & Transportation Search Autonomous Agents
idean3885
A
license
A
quality
B
maintenance
Enables AI agents to plan trips by searching flights, accommodations, and activities, and managing itineraries collaboratively with role-based permissions.
Updated 9 days ago (2026-09-01 10:04 UTC)
20
0
1
MIT
Trip Planner MCP Server
Travel & Transportation Weather Services
Shivanilarokar
F
license
Not graded
quality
B
maintenance
Enables 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.
Updated 2 months ago (2026-07-12 17:44 UTC)
-
TravelGenie
AjaykumarBalakannan
A
license
Not graded
quality
C
maintenance
Coordinates flights, hotels, events, weather, currency, and traffic data through a single MCP server, enabling comprehensive trip planning via natural language prompts.
Updated 2 months ago (2026-07-22 16:48 UTC)
MIT