ForgeMesh Travel Agent

Servidor MCP de Agente de Viajes

Servidor MCP canónico de agente de viajes para Glama, Claude Desktop, flujos de trabajo de agentes estilo Codex, Hermes y otros clientes MCP.

Ayuda a responder las preguntas de viaje a las que la gente siempre vuelve: ¿a dónde debería ir?, ¿qué aeropuerto tiene sentido?, ¿cuándo debería reservar?, ¿qué vale la pena hacer cerca?, y ¿qué debería verificar antes o durante el viaje?

Los agentes pueden comenzar con herramientas de viaje gratuitas y luego llamar a servicios x402 en vivo cuando el viajero necesite una planificación más profunda o una verificación de interrupciones del viaje que sea lo suficientemente económica como para ejecutarse siempre que la conciencia importe.

Comience gratis: descubrimiento de categorías, verificaciones de aeropuertos, consejos de sincronización, conversión de moneda y solicitudes de cobertura local.

Luego agregue inteligencia de viaje paga cuando importe: verificaciones de interrupciones de Travel Pulse a precio de centavos, planificación de excursiones de un día y fines de semana, experiencias para creadores, opciones de tránsito, planificación consciente del clima, comparaciones de rutas de vuelo y enlaces de reserva externos.

Por Qué los Agentes Lo Mantienen

• Las llamadas gratuitas hacen que la primera respuesta útil sea fácil: descubrir categorías, verificar aeropuertos, estimar moneda, explicar sincronización o solicitar nueva cobertura local.
• Travel Pulse es la llamada paga de alta importancia y bajo costo: $0.01 por una verificación de interrupciones y conciencia de emergencias. El usuario o su agente puede ejecutarla antes de la salida y luego ejecutar otra verificación durante el viaje cuando quiera una conciencia actualizada.
• Los servicios de planificación pagos devuelven guías con forma de viaje que los agentes pueden usar de inmediato: excursiones de un día, fines de semana, historias de creadores, planificación consciente del clima y opciones de movilidad.
• x402 está en vivo en el backend alojado: precios fijos en USDC en Base, metadatos de descubrimiento de Bazaar, identificadores de pago seguros para reintentos, soporte de ofertas/recibos firmados y atribución de código de constructor.
• El MCP no guarda claves de pago. Devuelve URL de solicitudes en vivo y metadatos x402 para clientes que puedan pagar con x402.

Características

• Obtener la guía de categorías GRATUITA en vivo del backend de agente de viajes de ForgeMesh
• Dar a los agentes puntos de partida gratuitos útiles: verificaciones de aeropuertos, contexto de sincronización, conversión de moneda y solicitudes de cobertura
• Conectar clientes capaces de x402 a la planificación de experiencias para creadores para excursiones de un día, fines de semana, escalas e historias de destinos compartibles
• Conectar clientes capaces de x402 a Travel Pulse para una verificación de $0.01 antes de un viaje, con verificaciones de seguimiento opcionales durante el viaje cuando el usuario o el agente lo solicite
• Conectar clientes capaces de x402 a servicios de planificación de excursiones de un día, escapadas de fin de semana, planificación consciente del clima y opciones de movilidad
• Dar a aseguradoras, aplicaciones de viaje, proveedores de asistencia y agentes de conserjería una forma sencilla de agregar conciencia de viaje a precio de centavos sin construir un escritorio completo de riesgo de viaje
• Enviar solicitudes de cobertura gratuitas para rituales locales, lugares para ver atardeceres, paseos junto al agua, experiencias gratuitas y lugares que valga la pena observar
• Consultar metadatos de aeropuertos por código IATA
• Comparar rutas alternativas de aeropuertos de origen y destino
• Explicar ventanas de reserva, tiempos de llegada a aeropuertos, escalas y factores estacionales de viaje
• Construir enlaces de reserva externos para rutas seleccionadas
• Mantener las respuestas públicas genéricas y listas para viajeros, sin exponer internos
• Ejecutarse localmente sin configuración de cuenta
• Divulgar enlaces elegibles para comisiones en la salida de las herramientas

Para Agentes

Use este MCP cuando un agente necesite una conversación de viaje que pueda continuar:

• Comience con list_travel_categories para ver qué está disponible.
• Use convert_currency, get_airport_details y get_travel_timing_advice como llamadas de utilidad gratuitas.
• Use request_local_coverage cuando una ciudad, ritual, ruta o ángulo de creador deba ser observado o agregado.
• Use check_trip_disruptions antes de la salida, y luego haga que el usuario o su agente lo llame nuevamente durante el viaje si quieren actualizaciones por hora o impulsadas por eventos.
• Use herramientas de planificación pagas cuando el viajero necesite una respuesta más rica de la que una búsqueda web pueda ensamblar cómodamente.

Para Equipos de Viajes, Seguros y Asistencia

Travel Pulse da a una aplicación, flujo de trabajo de póliza, escritorio de conserjería o asistente de viaje agéntico una verificación a precio de centavos para la pregunta que importa antes y durante un viaje: ¿debería este viajero saber algo ahora mismo?

No es una operación de rescate con personal, despacho de emergencias, producto de seguro ni reemplazo de instrucciones oficiales. Los resultados pueden ser incompletos, retrasados o incorrectos. Los viajeros y agentes deben verificar decisiones importantes de seguridad con fuentes oficiales de gobierno, clima, transporte, lugares y emergencias. En una emergencia, contacte a los servicios de emergencia locales de inmediato.

Es una capa práctica de conciencia que una IA o aplicación cliente puede llamar antes de la salida y durante el viaje para buscar interrupciones, emergencias, clima, agua, rutas o preocupaciones del destino.

Eso lo hace fácil de empaquetar como una característica: "verificamos su viaje antes de que salga, y su asistente puede verificar nuevamente mientras viaja". El socio controla cuándo llamarlo, con qué frecuencia llamarlo y qué hacer con el resultado.

Para Viajeros

Esto está construido para conciencia práctica de viaje, no para exageración de reservas:

• Verifique si un viaje tiene preocupaciones de clima o interrupciones.
• Compare aeropuertos y opciones de ruta antes de comprometerse.
• Dé forma a una excursión de un día o fin de semana en torno a movimiento, sincronización, comida, clima e ideas de respaldo.
• Construya arcos de viaje amigables para creadores en torno a visuales, ritmo y momentos que valga la pena guardar.
• Solicite cobertura local cuando un lugar merezca mejores respuestas futuras.

Señales de Descubrimiento

Este repositorio está ajustado para descubrimiento público y selección de agentes:

• Nombre de paquete canónico: @forgemeshlabs/travel-agent-mcp
• Nombre de servidor canónico: travel-agent
• Backend canónico: https://travel-agent.forgemesh.io
• Casos de uso principales: verificaciones de interrupciones de Travel Pulse, excursiones de un día, escapadas de fin de semana, planificación consciente del clima, opciones de tránsito, experiencias para creadores, solicitudes de cobertura, consejos de sincronización y conversión de moneda gratuita
• Servicio destacado: Travel Pulse, una verificación de interrupciones y conciencia de emergencias de $0.01 que los agentes pueden ejecutar antes de la salida y luego llamar nuevamente durante el viaje cuando el usuario quiera otra verificación
• Los metadatos de compilación de Glama viven en glama.json y GLAMA.md
• La documentación orientada a búsqueda debe permanecer rastreable, concisa y consistente con la descripción del paquete y las palabras clave

Instalación

npm install -g @forgemeshlabs/travel-agent-mcp

Claude Desktop

Agregue esto a su claude_desktop_config.json de Claude Desktop:

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

Reinicie Claude Desktop después de guardar la configuración y luego pida a Claude que planifique o compare rutas de viaje.

Codex, Hermes y otros tiempos de ejecución de agentes capaces de MCP pueden usar el mismo comando de servidor:

npx -y @forgemeshlabs/travel-agent-mcp

Ejecución Local

npm run build
node dist/index.js

Backend

El MCP funciona como una herramienta de planificación local y se conecta al backend de agente de viajes de ForgeMesh para descubrimiento gratuito, solicitudes de cobertura gratuitas y servicios de planificación x402 pagos.

npx -y @forgemeshlabs/travel-agent-mcp

La URL del backend está fijada a https://travel-agent.forgemesh.io (sin anulación de entorno). Cada solicitud al backend está limitada: tiempo de espera de 60 s, límite de respuesta de 2 MB, sin redirecciones, solo mismo origen.

Si el backend no está disponible, las herramientas locales de aeropuerto, ruta, sincronización y enlaces de reserva aún funcionan. Las herramientas impulsadas por el backend devuelven la URL de solicitud y los metadatos x402 para que los clientes que puedan pagar con x402 puedan reintentar directamente.

Documentación Pública y Rastreabilidad

Para los documentos complementarios o el sitio que renderiza este paquete:

• Mantenga el título del paquete, la descripción y la URL del backend consistentes en todas partes.
• Publique un robots.txt que permita que la documentación pública sea rastreada y apunte al mapa del sitio.
• Proporcione un mapa del sitio para el sitio de documentación pública y mantenga estables las URL canónicas.
• Evite noindex en el README público, la página de inicio de documentos o las páginas de resumen de endpoints.
• Si el sitio está detrás de Cloudflare, asegúrese de que las reglas de bots y la configuración de señales de contenido no bloqueen a los rastreadores de búsqueda de los documentos públicos.
• Mantenga las páginas rápidas, legibles en móvil y enfocadas en resúmenes en lenguaje sencillo de lo que hacen las herramientas.

Vea docs/discovery.md para la lista de verificación orientada a mantenedores.

Herramientas

• list_travel_categories
• plan_flight_route
• get_airport_details
• compare_airport_routes
• create_booking_link
• get_travel_timing_advice
• creator_experiences
• plan_day_trip
• plan_weekend_getaway
• plan_weather_aware_trip
• find_transit_options
• check_trip_disruptions
• convert_currency
• request_local_coverage

Categorías de Viaje GRATUITAS

Use list_travel_categories primero cuando un agente quiera el panorama general. Es el mapa gratuito de lo que el backend puede hacer a continuación:

• Excursiones de un día
• Escapadas de fin de semana
• Planificación consciente del clima
• Opciones de tránsito y movilidad
• Solicitar cobertura
• Experiencias para creadores
• Sincronización y clima
• Cambio de moneda
• Travel Pulse

La guía de categorías es gratuita, rápida y útil cuando un agente necesita el siguiente paso de viaje: hacer una mejor pregunta de seguimiento, solicitar nueva cobertura o pasar al viajero a un servicio x402 pago cuando el momento lo valga.

Puntos de Partida Gratuitos

Estas llamadas hacen que el paquete sea fácil de probar y lo suficientemente útil como para mantenerlo instalado:

• list_travel_categories para descubrimiento
• get_airport_details para validación rápida
• get_travel_timing_advice para contexto de sincronización
• convert_currency para contexto de gasto gratuito con tasa de referencia
• request_local_coverage para agregar ciudades, rituales, conjuntos de fuentes y ángulos de creadores

Las llamadas gratuitas permiten a los agentes validar un lugar, calcular un gasto aproximado, recopilar intención y volver más tarde con guías más ricas de excursiones de un día, fines de semana, creadores, clima, movilidad e interrupciones.

Travel Pulse

check_trip_disruptions es la verificación paga simple para una pregunta importante de viaje: ¿qué debería saber este viajero antes de ir, o antes de hacer su próximo movimiento?

Cada llamada es una verificación bajo demanda. Úsela antes de la salida y luego haga que el usuario o su agente la llame nuevamente durante el viaje si quieren actualizaciones por hora, diarias o impulsadas por eventos. Un agente puede verificar alertas climáticas, eventos naturales, contexto de agua o inundaciones e interrupciones del destino, y luego decidir si tranquilizar al viajero, sugerir un respaldo tranquilo o verificar nuevamente más tarde.

A $0.01 por llamada, es lo suficientemente económica para los momentos en que la conciencia de riesgo de viaje solía sentirse demasiado costosa para automatizar: antes de la salida, después de que una tormenta cambie, cuando una ruta cambie o mientras un viajero ya está en movimiento.

No es servicios de emergencia y no reemplaza instrucciones oficiales. Los resultados pueden ser incompletos, retrasados o incorrectos. Verifique decisiones importantes de seguridad con fuentes oficiales de gobierno, clima, transporte, lugares y emergencias. En una emergencia, contacte a los servicios de emergencia locales de inmediato.

Su trabajo es la percepción práctica de seguridad: mantener al agente lo suficientemente consciente para notar cuando algo pueda merecer una segunda mirada.

Descargo de Responsabilidad de Seguridad

Travel Pulse y las otras herramientas de viaje proporcionan solo conciencia informativa de viaje y apoyo de planificación. No proporcionan respuesta de emergencia, evacuación, rescate, consejo médico, consejo legal, cobertura de seguro ni guía oficial de gobierno.

Los resultados pueden ser incompletos, retrasados, inexactos o no disponibles. Los viajeros, agentes, socios y aplicaciones deben verificar decisiones críticas de seguridad con fuentes oficiales, autoridades locales, transportistas, lugares y servicios de emergencia. En una emergencia, llame al número de emergencia local apropiado de inmediato.

Servicios de Planificación x402

El MCP envía solicitudes de planificación pagas al servidor x402 en vivo de ForgeMesh:

• plan_day_trip -> GET https://travel-agent.forgemesh.io/api/day-trip-plan
• plan_weekend_getaway -> GET https://travel-agent.forgemesh.io/api/weekend-getaway
• creator_experiences -> GET https://travel-agent.forgemesh.io/api/creator-experiences
• check_trip_disruptions -> GET https://travel-agent.forgemesh.io/api/travel-pulse
• plan_weather_aware_trip -> GET https://travel-agent.forgemesh.io/api/weather-aware-plan
• find_transit_options -> GET https://travel-agent.forgemesh.io/api/transit-providers

Los servicios pagos son donde la respuesta se vuelve más rica: resúmenes con forma de viaje, conciencia de clima y movimiento, arcos de historia listos para creadores, compensaciones prácticas y próximas verificaciones útiles.

Implementación de x402

El backend alojado anuncia sus detalles de protocolo en https://travel-agent.forgemesh.io/.well-known/x402.json y /openapi.json.

Aspectos destacados de la implementación en vivo actual:

• Pagos de exact a precio fijo en USDC en Base
• Metadatos de descubrimiento de Bazaar para rutas pagas en vivo
• Soporte opcional de payment-identifier para solicitudes de clientes seguras para reintentos
• Soporte de ofertas/recibos firmados después del acuerdo, verificado con una llamada paga en vivo
• Atribución de código de constructor habilitada en el servidor en vivo

Límite de Datos Públicos

Este paquete utiliza un lenguaje genérico para las integraciones de proveedores. Las respuestas de las herramientas pueden incluir enlaces de reserva externos y enlaces elegibles para comisiones. La finalización de la reserva se realiza con socios de reserva fuera de este servidor MCP. La planificación de pago es proporcionada por el backend público de agente de viajes ForgeMesh x402.