# forgemeshlabs/travel-agent-mcp [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/forgemeshlabs/travel-agent-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 435  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/forgemeshlabs-travel-agent-mcp

## Description
Free travel utilities plus live x402 travel intelligence: $0.01 Travel Pulse disruption and emergency-awareness checks, day trips, weekend getaways, creator experiences, weather-aware planning, mobility options, currency conversion, airport checks, and timing guidance.

## Tools
Capabilities this server exposes over MCP:

- **list_travel_categories** — FREE live category guide from the ForgeMesh travel-agent backend. Use this first to see the available travel flows and choose the next useful call: free airport/timing/coverage tools or paid x402 planning services. Read-only, no account setup, no booking side effects.
- **plan_flight_route** — Plan one flight route between two airports. Use when a traveler wants a clear starting point for a specific origin and destination; use compare_airport_routes for multiple route choices, create_booking_link only when route details are already known, and get_airport_details only to validate one airport. Read-only, no account setup, no booking side effects. return_date is optional; omit it for one-way trips. Responses include route metadata and may include commission-eligible external booking links.
- **get_airport_details** — FREE look up details for one airport by IATA code. Use to validate or explain a single airport before route planning; use plan_flight_route for an actual trip route and compare_airport_routes for multiple origin-destination pairs. Read-only, no account setup, no external booking links, and no booking side effects.
- **compare_airport_routes** — Compare two or more airport route pairs side by side. Use when a traveler is choosing between alternate origins, destinations, or nearby airports; use plan_flight_route for one dated route and get_airport_details for a single airport lookup. Read-only, no account setup, no booking side effects. Responses may include commission-eligible external booking links for each route.
- **create_booking_link** — Create an external booking link for an already chosen route. Use after route details are known or after compare_airport_routes or plan_flight_route; use another planning tool first when the traveler still needs help choosing. Read-only, no account setup, no booking completion, and no reservation side effects. The returned link may be commission-eligible and is disclosed in output.
- **get_travel_timing_advice** — FREE practical travel timing advice, including booking windows, airport arrival timing, layovers, and seasonal considerations. Use for questions like when to book or how early to arrive; use plan_flight_route when the traveler wants route planning. Read-only, no account setup, no external booking link, and no booking side effects.
- **convert_currency** — FREE live reference-rate currency conversion from the ForgeMesh travel-agent backend. Use when a traveler or agent needs quick spending context before deciding whether to ask for richer x402 trip guidance. Read-only, no account setup, no payment, and not a transaction quote.
- **creator_experiences** — Connect to the live paid x402 creator-experience service for travelers, creators, influencers, and agents planning a shareable day trip, weekend, layover, or destination story. Use when the traveler cares about visuals, story, timing, food stops, scenic movement, weather-aware backups, or content moments. The MCP can return live server output or x402 request metadata for clients that can pay with x402.
- **plan_day_trip** — Connect to the live paid x402 day-trip service for a destination, route, or origin-based ask. Use when a traveler wants a relaxed day out with timing, water, food, transit, weather, and backup options. The MCP can return live server output or x402 request metadata for clients that can pay with x402.
- **plan_weekend_getaway** — Connect to the live paid x402 weekend-getaway service for a short overnight escape. Use when the traveler wants a calmer planning brief with lodging posture, water/weather fit, transportation, and easy backup ideas. The MCP can return live server output or x402 request metadata for clients that can pay with x402.
- **plan_weather_aware_trip** — Connect to the live paid x402 weather-aware planning service for a destination or coordinate pair. Use when the traveler wants rain, heat, wind, and indoor backup awareness before committing to outdoor time.
- **find_transit_options** — Connect to the live paid x402 mobility-options service for a location and transportation type. Use when the traveler wants transit, rail, ferry, trails, bike/scooter options, or a location-filtered short list before planning the rest of the trip.
- **check_trip_disruptions** — Check for travel disruptions before departure or during a trip with the live paid x402 Travel Pulse service. Each $0.01 call is one on-demand disruption and emergency-awareness check: an agent can run it before the traveler leaves, then call it again during the trip if the user wants hourly, daily, or event-driven updates. Use for weather alerts, natural events, water/flood context, route or destination disruption awareness, travel-risk awareness, and calm backup considerations. Informational only: results can be incomplete, delayed, or incorrect. Not emergency services, not staffed monitoring, and not a substitute for official instructions or local emergency authorities.
- **request_local_coverage** — FREE live backend call for requesting coverage for a town, neighborhood, local ritual, free experience, or source set. Use this when you want the system to remember a place worth watching: local vibe, freebie list, sunset walk, opening-soon pattern, or creator angle.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "travel-agent-mcp": {
    "command": "npx",
    "args": ["-y","@forgemeshlabs/travel-agent-mcp"]
  }
}
```

## Documentation

## What forgemeshlabs/travel-agent-mcp MCP server does

The forgemeshlabs/travel-agent-mcp MCP server exposes travel planning and reference operations through MCP. Its free tools cover category discovery, airport information, route planning, route comparison, travel timing, reference-rate currency conversion, and requests for future local coverage. It also provides access to backend services for richer trip planning and disruption awareness.

The package does not complete reservations. Route tools may produce external booking links, and those links can be commission-eligible; the output discloses that status. Booking-link creation is limited to generating a link for a route that has already been selected.

## How it works

A client can begin with `list_travel_categories` to identify the available travel flows. Free calls can then validate an airport, compare alternate airport pairs, estimate travel timing, convert currencies, or submit a coverage request for a place or local experience.

For more involved requests, the MCP connects to the ForgeMesh travel-agent backend. Paid x402 services cover day trips, weekend escapes, creator-oriented experiences, weather-aware planning, mobility options, and Travel Pulse disruption checks. The client may receive live service output or request metadata that an x402-capable client can use to retry and pay. Travel Pulse costs $0.01 per disruption and emergency-awareness check, allowing a client to check before departure and call again during a trip when appropriate.

The server does not retain payment keys. The backend uses fixed-price USDC payments on Base and provides x402-related metadata, including payment identifiers and signed offer or receipt support, according to the project documentation.

## Setup and configuration

Install the published npm package globally with `npm install -g @forgemeshlabs/travel-agent-mcp`, or run it directly with `npx -y @forgemeshlabs/travel-agent-mcp`. For Claude Desktop, configure an MCP server named `travel-agent` with `npx` as the command and `-y @forgemeshlabs/travel-agent-mcp` as its arguments. The same command is documented for Codex, Hermes, and other MCP-capable runtimes.

The default backend is `https://travel-agent.forgemesh.io`. Set `TRAVEL_AGENT_SERVER_URL` if the process should use another backend endpoint. A local build can also be started with `npm run build` followed by `node dist/index.js`.

## Tools and capabilities

The forgemeshlabs/travel-agent-mcp MCP server includes these tool groups:

- Discover available travel categories and backend flows.
- Look up airport details using an IATA code.
- Plan one route or compare multiple airport route pairs.
- Create an external booking link after route details are known.
- Provide booking-window, airport-arrival, layover, and seasonal timing guidance.
- Convert currencies using live reference rates without making a transaction.
- Plan day trips, weekend getaways, creator experiences, and weather-aware itineraries.
- Find transit, rail, ferry, trail, bicycle, and scooter options by location and type.
- Check disruption, weather, natural-event, route, water, and destination awareness through Travel Pulse.
- Request coverage for towns, neighborhoods, local rituals, free activities, or creator-oriented places.

## Limitations and notes

Free and paid capabilities are not equivalent. Backend planning and Travel Pulse calls may require an x402-capable client and payment, while local airport, route, timing, and booking-link operations can continue if the backend is unavailable.

Travel Pulse is informational, not emergency dispatch, staffed monitoring, insurance, or rescue support. Its results may be incomplete, delayed, or incorrect. Important safety decisions should be checked against official government, weather, transportation, venue, and emergency sources; emergencies should be directed to local emergency services.

Currency conversion provides reference-rate context rather than a transaction quote. The server has no account setup requirement, does not complete bookings, and does not create reservation side effects. External booking links may be commission-eligible and are disclosed in tool output.

_Full upstream README: https://allmcps.com/mcp/forgemeshlabs-travel-agent-mcp/readme_