ForgeMesh Travel Agent

Ferramentas de viagem gratuitas, além do Travel Pulse x402 ao vivo, passeios de um dia, fins de semana, clima e inteligência de mobilidade.

GitHub
1

Documentação

Servidor MCP de Agente de Viagens

M8ven Verified

Servidor MCP canônico de agente de viagens para Glama, Claude Desktop, fluxos de trabalho de agente estilo Codex, Hermes e outros clientes MCP.

Ele ajuda a responder às perguntas de viagem que as pessoas sempre fazem: para onde devo ir, qual aeroporto faz sentido, quando devo reservar, o que vale a pena fazer nas proximidades e o que devo verificar antes ou durante a viagem?

Os agentes podem começar com ferramentas de viagem gratuitas e depois chamar serviços x402 ao vivo quando o viajante precisar de um planejamento mais aprofundado ou de uma verificação de interrupção de viagem que seja barata o suficiente para ser executada sempre que a conscientização for importante.

Comece gratuitamente: descoberta de categorias, verificações de aeroportos, conselhos de planejamento, conversão de moedas e solicitações de cobertura local.

Depois, adicione inteligência de viagem paga quando for importante: verificações de interrupção do Travel Pulse com preço de centavos, planejamento de passeios de um dia e fins de semana, experiências para criadores, opções de transporte, planejamento consciente do clima, comparações de rotas de voo e links de reserva externos.

Por que os Agentes Mantêm Isso

  • Chamadas gratuitas facilitam a primeira resposta útil: descubra categorias, verifique aeroportos, estime moedas, explique o planejamento ou solicite nova cobertura local.
  • O Travel Pulse é a chamada paga de alta importância e baixo custo: $0.01 para uma verificação de interrupção e conscientização de emergência. O usuário ou seu agente pode executá-la antes da partida e depois executar outra verificação durante a viagem sempre que quiser uma conscientização atualizada.
  • Os serviços de planejamento pagos retornam orientações em formato de viagem que os agentes podem usar imediatamente: passeios de um dia, fins de semana, histórias de criadores, planejamento consciente do clima e opções de mobilidade.
  • O x402 está ativo no backend hospedado: pagamentos USDC com preço fixo na Base, metadados de descoberta do Bazaar, identificadores de pagamento seguros para novas tentativas, suporte a ofertas/recibos assinados e atribuição de código do criador.
  • O MCP não guarda chaves de pagamento. Ele retorna URLs de solicitação ao vivo e metadados x402 para clientes que podem pagar com x402.

Recursos

  • Obtenha o guia de categorias GRATUITO ao vivo do backend do agente de viagens ForgeMesh
  • Dê aos agentes pontos de partida gratuitos úteis: verificações de aeroportos, contexto de planejamento, conversão de moedas e solicitações de cobertura
  • Conecte clientes compatíveis com x402 ao planejamento de experiências para criadores para passeios de um dia, fins de semana, escalas e histórias de destinos compartilháveis
  • Conecte clientes compatíveis com x402 ao Travel Pulse para uma verificação de $0.01 antes de uma viagem, com verificações de acompanhamento opcionais durante a viagem quando o usuário ou agente solicitar
  • Conecte clientes compatíveis com x402 a serviços de planejamento de passeios de um dia, escapadas de fim de semana, planejamento consciente do clima e opções de mobilidade
  • Dê a seguradoras, aplicativos de viagem, provedores de assistência e agentes de concierge uma maneira simples de adicionar conscientização de viagem com preço de centavos sem construir uma central completa de risco de viagem
  • Envie solicitações de cobertura gratuitas para rituais locais, pontos de pôr do sol, caminhadas à beira d'água, experiências gratuitas e lugares que valem a pena acompanhar
  • Consulte metadados de aeroportos pelo código IATA
  • Compare rotas alternativas de aeroportos de origem e destino
  • Explique janelas de reserva, horários de chegada ao aeroporto, escalas e fatores sazonais de viagem
  • Crie links de reserva externos para rotas selecionadas
  • Mantenha as respostas públicas genéricas e prontas para o viajante, sem expor detalhes internos
  • Execute localmente sem configuração de conta
  • Divulgue links elegíveis a comissões na saída das ferramentas

Para Agentes

Use este MCP quando um agente precisar de uma conversa de viagem que possa continuar:

  • Comece com list_travel_categories para ver o que está disponível.
  • Use convert_currency, get_airport_details e get_travel_timing_advice como chamadas utilitárias gratuitas.
  • Use request_local_coverage quando uma cidade, ritual, rota ou ângulo de criador deve ser acompanhado ou adicionado.
  • Use check_trip_disruptions antes da partida e depois peça ao usuário ou ao agente para chamá-lo novamente durante a viagem se quiserem atualizações por hora ou orientadas a eventos.
  • Use ferramentas de planejamento pagas quando o viajante precisar de uma resposta mais rica do que uma busca na web pode montar confortavelmente.

Para Equipes de Viagem, Seguros e Assistência

O Travel Pulse dá a um aplicativo, fluxo de trabalho de apólice, central de concierge ou assistente de viagem agêntico uma verificação com preço de centavos para a pergunta que importa antes e durante uma viagem: este viajante deveria saber algo agora?

Não é uma operação de resgate com equipe, despacho de emergência, produto de seguro ou substituto para instruções oficiais. Os resultados podem estar incompletos, atrasados ou errados. Viajantes e agentes devem verificar decisões importantes de segurança com fontes oficiais do governo, clima, transporte, locais e emergências. Em uma emergência, contate os serviços de emergência locais imediatamente.

É uma camada prática de conscientização que uma IA ou aplicativo cliente pode chamar antes da partida e durante a viagem para procurar preocupações com interrupções, emergências, clima, água, rotas ou destinos.

Isso facilita o empacotamento como um recurso: "verificamos sua viagem antes de você sair, e seu assistente pode verificar novamente enquanto você viaja." O parceiro controla quando chamar, com que frequência chamar e o que fazer com o resultado.

Para Viajantes

Isso é feito para conscientização prática de viagem, não para hype de reservas:

  • Verifique se uma viagem tem preocupações com clima ou interrupções.
  • Compare aeroportos e opções de rota antes de se comprometer.
  • Molde um passeio de um dia ou fim de semana em torno de deslocamento, horários, comida, clima e ideias de reserva.
  • Crie arcos de viagem amigáveis para criadores em torno de visuais, ritmo e momentos que valem a pena guardar.
  • Peça cobertura local quando um lugar merecer melhores respostas futuras.

Sinais de Descoberta

Este repositório é ajustado para descoberta pública e seleção de agentes:

  • Nome canônico do pacote: @forgemeshlabs/travel-agent-mcp
  • Nome canônico do servidor: travel-agent
  • Backend canônico: https://travel-agent.forgemesh.io
  • Casos de uso principais: verificações de interrupção do Travel Pulse, passeios de um dia, escapadas de fim de semana, planejamento consciente do clima, opções de transporte, experiências para criadores, solicitações de cobertura, conselhos de planejamento e conversão de moedas gratuita
  • Serviço em destaque: Travel Pulse, uma verificação de interrupção e conscientização de emergência de $0.01 que os agentes podem executar antes da partida e chamar novamente durante a viagem quando o usuário quiser outra verificação
  • Os metadados de build do Glama ficam em glama.json e GLAMA.md
  • A documentação voltada para busca deve permanecer rastreável, concisa e consistente com a descrição do pacote e as palavras-chave

Instalação

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

Claude Desktop

Adicione isto ao seu claude_desktop_config.json do Claude Desktop:

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

Reinicie o Claude Desktop após salvar a configuração e peça ao Claude para planejar ou comparar rotas de viagem.

Codex, Hermes e outros runtimes de agente compatíveis com MCP podem usar o mesmo comando de servidor:

npx -y @forgemeshlabs/travel-agent-mcp

Execução Local

npm run build
node dist/index.js

Backend

O MCP funciona como uma ferramenta de planejamento local e se conecta ao backend do agente de viagens ForgeMesh para descoberta gratuita, solicitações de cobertura gratuitas e serviços de planejamento x402 pagos.

npx -y @forgemeshlabs/travel-agent-mcp

A URL do backend é fixa em https://travel-agent.forgemesh.io (sem override de ambiente). Cada solicitação ao backend é limitada: timeout de 60 s, limite de resposta de 2 MB, sem redirecionamentos, apenas mesma origem.

Se o backend estiver indisponível, as ferramentas locais de aeroporto, rota, planejamento e links de reserva ainda funcionam. As ferramentas baseadas no backend retornam a URL da solicitação e os metadados x402 para que clientes que podem pagar com x402 possam tentar novamente diretamente.

Documentação Pública e Rastreabilidade

Para a documentação complementar ou site que renderiza este pacote:

  • Mantenha o título do pacote, a descrição e a URL do backend consistentes em todos os lugares.
  • Publique um robots.txt que permita que a documentação pública seja rastreada e aponte para o sitemap.
  • Forneça um sitemap para o site de documentação pública e mantenha URLs canônicas estáveis.
  • Evite noindex no README público, na página inicial da documentação ou nas páginas de resumo de endpoints.
  • Se o site estiver atrás do Cloudflare, certifique-se de que as regras de bots e as configurações de sinais de conteúdo não bloqueiem rastreadores de busca da documentação pública.
  • Mantenha as páginas rápidas, legíveis no celular e focadas em resumos em linguagem simples do que as ferramentas fazem.

Veja docs/discovery.md para a lista de verificação voltada para mantenedores.

Ferramentas

  • 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

Categorias de Viagem GRATUITAS

Use list_travel_categories primeiro quando um agente quiser entender o cenário. É o mapa gratuito do que o backend pode fazer em seguida:

  • Passeios de um dia
  • Escapadas de fim de semana
  • Planejamento consciente do clima
  • Opções de transporte e mobilidade
  • Solicitar cobertura
  • Experiências para criadores
  • Planejamento e clima
  • Câmbio de moedas
  • Travel Pulse

O guia de categorias é gratuito, rápido e útil quando um agente precisa do próximo passo de viagem: fazer uma pergunta de acompanhamento melhor, solicitar nova cobertura ou encaminhar o viajante para um serviço x402 pago quando o momento valer a pena.

Pontos de Partida Gratuitos

Estas chamadas tornam o pacote fácil de experimentar e útil o suficiente para manter instalado:

  • list_travel_categories para descoberta
  • get_airport_details para validação rápida
  • get_travel_timing_advice para contexto de planejamento
  • convert_currency para contexto de gastos com taxa de referência gratuita
  • request_local_coverage para adicionar cidades, rituais, conjuntos de fontes e ângulos de criadores

As chamadas gratuitas permitem que os agentes validem um lugar, estimem um gasto aproximado, coletem intenção e voltem depois com orientações mais ricas de passeios de um dia, fins de semana, criadores, clima, mobilidade e interrupções.

Travel Pulse

check_trip_disruptions é a verificação paga simples para uma pergunta importante de viagem: o que este viajante deveria saber antes de ir, ou antes de tomar o próximo passo?

Cada chamada é uma verificação sob demanda. Use antes da partida e depois peça ao usuário ou ao agente para chamá-lo novamente durante a viagem se quiserem atualizações por hora, diárias ou orientadas a eventos. Um agente pode verificar alertas de clima, eventos naturais, contexto de água ou enchentes e interrupções de destino, e então decidir se deve tranquilizar o viajante, sugerir um plano reserva calmo ou verificar novamente mais tarde.

A $0.01 por chamada, é barato o suficiente para os momentos em que a conscientização de risco de viagem costumava parecer cara demais para automatizar: antes da partida, depois que uma tempestade muda, quando uma rota muda ou enquanto um viajante já está em movimento.

Não é serviço de emergência e não substitui instruções oficiais. Os resultados podem estar incompletos, atrasados ou errados. Verifique decisões importantes de segurança com fontes oficiais do governo, clima, transporte, locais e emergências. Em uma emergência, contate os serviços de emergência locais imediatamente.

Seu trabalho é a percepção prática de segurança: manter o agente consciente o suficiente para notar quando algo pode merecer uma segunda olhada.

Aviso de Segurança

O Travel Pulse e as outras ferramentas de viagem fornecem apenas conscientização informacional de viagem e suporte de planejamento. Eles não fornecem resposta a emergências, evacuação, resgate, aconselhamento médico, aconselhamento jurídico, cobertura de seguro ou orientação oficial do governo.

As saídas podem estar incompletas, atrasadas, imprecisas ou indisponíveis. Viajantes, agentes, parceiros e aplicativos devem verificar decisões críticas de segurança com fontes oficiais, autoridades locais, transportadoras, locais e serviços de emergência. Em uma emergência, ligue imediatamente para o número de emergência local apropriado.

Serviços de Planejamento x402

O MCP envia solicitações de planejamento pagas ao servidor x402 ao vivo do 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

Os serviços pagos são onde a resposta fica mais rica: briefings em formato de viagem, conscientização de clima e deslocamento, arcos de história prontos para criadores, tradeoffs práticos e próximas verificações úteis.

Implementação x402

O backend hospedado anuncia seus detalhes de protocolo em https://travel-agent.forgemesh.io/.well-known/x402.json e /openapi.json.

Destaques atuais da implementação ao vivo:

  • Pagamentos exact com preço fixo em USDC na Base
  • Metadados de descoberta do Bazaar para rotas pagas ao vivo
  • Suporte opcional a payment-identifier para solicitações de cliente seguras para novas tentativas
  • Suporte a ofertas/recibos assinados após a liquidação, verificado com uma chamada paga ao vivo
  • Atribuição de código do criador habilitada no servidor ao vivo

Limite de Dados Públicos

Este pacote usa linguagem genérica para integrações de provedores. As respostas das ferramentas podem incluir links externos de reserva e links elegíveis a comissão. A conclusão da reserva acontece com parceiros de reserva fora deste servidor MCP. O planejamento pago é fornecido pelo backend público do agente de viagens ForgeMesh x402.