roomesto.com
Guias

Conecte a pesquisa de hotéis Roomesto ao seu assistente de IA

roomesto.com executa um servidor MCP público. Conecte-o uma vez — e o Claude Desktop, Cursor ou qualquer outro cliente MCP encontrará preços e disponibilidade de hotéis em tempo real em uma conversa simples.

Limites de solicitações

  • Sem registro — até 10 solicitações por dia a partir de um endereço IP.
  • Com uma chave pessoal (gratuita, para usuários registrados) — até 100 solicitações por dia.
  • Os contadores são redefinidos à meia-noite UTC.

1Obtenha sua chave pessoal

Registre-se ou faça login e abra a página da sua conta — sua chave está pronta na seção “Acesso MCP”: Abrir Minha Conta →

2Endereço do servidor

Adicione esta URL ao seu cliente MCP como um servidor HTTP remoto:

https://roomesto.com/mcp

3Adicione o servidor à configuração

Claude Desktop / Cursor (mcp.json / claude_desktop_config.json):

{
  "mcpServers": {
    "roomesto": {
      "url": "https://roomesto.com/mcp",
      "headers": { "Authorization": "Bearer rms_YOUR_KEY" }
    }
  }
}

Ou uma linha no terminal (Claude Code):

claude mcp add --transport http roomesto https://roomesto.com/mcp --header "Authorization: Bearer rms_YOUR_KEY"

O que você pode perguntar

  • “Hotéis em Roma perto da Fontana di Trevi, 12–15 de setembro, abaixo de €150 por noite”
  • “Hotel familiar em Antalya com clube infantil e refeições all-inclusive”
  • “Compare hotéis de 4 estrelas no centro de Istambul para uma estadia de fim de semana”
  • “Hotel mais barato à beira-mar em Sochi para duas pessoas em julho”

Reservar via MCP

Um viajante registado pode concluir uma reserva com a mesma ligação MCP. As ferramentas avançam passo a passo, para que o viajante veja o preço final e as condições antes de reservar ou pagar.

  1. search_hotels encontra ofertas em tempo real; get_hotel_rates devolve quartos, formas de pagamento, impostos e as condições de cancelamento do fornecedor.
  2. prepare_booking verifica novamente uma tarifa escolhida e recolhe os dados de todos os hóspedes. Reutilize o mesmo request_id se o pedido tiver de ser repetido.
  3. tokenize_booking_card só é usado quando a tarifa escolhida exige cartão. O número do cartão e o CVC são enviados ao processador de pagamentos existente e não ficam guardados no servidor MCP.
  4. confirm_booking exige a confirmação explícita do valor total exato e da moeda pelo viajante. Depois, get_booking_status acompanha a confirmação ou qualquer verificação bancária; cancel_booking pede o cancelamento de uma reserva feita com a mesma chave.

Se algo der errado

  • 429 “Limite gratuito diário atingido” — a cota diária foi usada. Ela é redefinida à meia-noite UTC; registre-se para obter 100 solicitações por dia com uma chave pessoal.
  • 401 “chave de API desconhecida” — certifique-se de que toda a chave começando com rms_ foi copiada sem espaços extras.

Para agentes de IA e rastreadores: llms.txt