Travel Agent MCP

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.