MoodTrip Hotel Search Skill

Pre-flight Check — EXECUTE THIS FIRST

Before attempting any hotel search, verify MoodTrip tools are accessible.

Step 1: Check for tools directly. Look for any of these tools in your available tool list: search_hotels, get_hotel_details, searchHotelsWithRates, findHotels, search_hotels_by_description, build_booking_link

If ANY of these tools are found → skip to Decision Rules and proceed normally.

Runtime detection: If you are running on OpenClaw, Codex, or any OpenAI-compatible runtime that validates tool schemas strictly, prefer search_hotels and get_hotel_details over searchHotelsWithRates and getHotelDetails. The wrapper tools have identical functionality with OpenAI-compliant schemas (no anyOf/oneOf at top level).

Step 2: Check if MCP server is already configured. If tools are not in your direct tool list, check whether api.moodtrip.ai or moodtrip is already configured as an MCP server anywhere in your platform config — including under any of these paths:

• mcp.servers.moodtrip
• plugins.entries.acpx.config.mcpServers.moodtrip
• skills.entries.moodtrip-hotel-search
• skills/moodtrip-hotel-search/_meta.json → mcpServers.moodtrip
• skills/moodtrip-hotel-search/.mcp.json

This skill ships with .mcp.json and _meta.json files that declare the MCP server configuration. If your platform reads these files from skill folders, the server should be auto-configured on install.

If these files are missing from the skill folder, this is an older version. Suggest the user update: clawhub update adiny/moodtrip-hotel-search or openclaw skills update

If the server IS configured but tools are not showing, this is likely a tool loading/exposure issue in the current session, not a missing connection. Restart the session or gateway if appropriate — some platforms only load MCP tools at session start.

Step 3: Auto-connect on OpenClaw when possible. If the server is NOT configured and you are running inside OpenClaw with config-edit capability:

• OpenClaw currently supports stdio MCP servers only (not HTTP). Use the mcp-remote bridge:
  • Add to config: mcpServers.moodtrip = { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://api.moodtrip.ai/api/mcp-http"] }
  • This wraps the HTTP MCP server as a stdio process that OpenClaw can load.
• If you have OpenClaw config tools available, patch config so the MCP server is added automatically.
• After adding it, restart/reload the gateway or start a fresh session — tools only load at session start.
• Then re-check whether the MoodTrip tools are exposed.

OpenClaw-specific rule:

• If the user asked to connect/install/fix MoodTrip MCP, and you can safely edit OpenClaw config, do it automatically instead of just telling the user to do it manually.
• Do NOT use mcp.servers.moodtrip.url (HTTP format) — it will be skipped. Use the stdio bridge format above.
• Do not invent tool availability; verify after restart/session refresh.

Step 4: Fallback if auto-connect is not possible. Only if auto-connect is not possible:

• mcporter available? Run: mcporter config add moodtrip https://api.moodtrip.ai/api/mcp-http
• clawhub available? Run: clawhub install adiny/moodtrip-hotel-search
• Neither available? Tell the user:

  "MoodTrip's hotel search tools aren't connected yet. Please add this MCP server in your platform settings: URL: https://api.moodtrip.ai/api/mcp-http No credentials required. For setup: https://github.com/adiny/moodtrip-hotel-search"

CRITICAL: Do NOT hallucinate hotel results. Do NOT call tools that don't exist. Do NOT attempt curl/fetch workarounds. If tools cannot be verified after all steps, help the user connect or restart the session.

---

This skill enables the agent to search, compare, evaluate, and hand off hotel bookings through the MoodTrip.ai MCP server. The server exposes 11 core tools covering the full hotel discovery-to-booking-handoff workflow.

Booking is link-based: the agent helps users find and compare hotels, then provides a direct booking URL. The user completes the reservation on the MoodTrip website.

Connection

MCP Server URL: https://api.moodtrip.ai/api/mcp-http Protocol: MCP Streamable HTTP (JSON-RPC 2.0) Authentication: Public read-only API — no credentials required. The server accepts only hotel search queries and returns publicly available hotel data.

For platform-specific setup instructions (Claude.ai, Claude Desktop, ChatGPT, OpenClaw), see: https://github.com/adiny/moodtrip-hotel-search

Quick Setup by Platform

Platform	How to Connect
OpenClaw	Uses stdio bridge via mcp-remote (bundled in .mcp.json); or clawhub install adiny/moodtrip-hotel-search
Claude Desktop	Add to claude_desktop_config.json — see GitHub README
ChatGPT	Add as MCP integration in platform settings
Any MCP client	Connect to https://api.moodtrip.ai/api/mcp-http

Privacy & Data Handling

• All tools are read-only — no user data is stored, modified, or deleted
• Search queries are processed in real-time and not persisted
• No personal identifiers (names, emails, payment info) are collected or requested
• The server accepts only hotel search parameters (city, dates, guests, preferences)
• Full privacy policy: https://moodtrip.ai/privacy

Decision Rules

Before calling any tool, apply these rules to pick the right one:

Condition	Tool
OpenClaw / Codex runtime — always prefer wrapper tools	Use search_hotels instead of searchHotelsWithRates, get_hotel_details instead of getHotelDetails
User has dates + destination + wants prices	search_hotels (preferred) or searchHotelsWithRates
User describes a vibe, mood, or style	search_hotels_by_description
User asks about one specific hotel	get_hotel_details (preferred) or getHotelDetails or ask_about_hotel
No pricing needed yet / just browsing	findHotels
User wants reviews or guest opinions	getHotelReviews
User wants to find a specific room type or match a photo	search_rooms_by_description
Previous search returned no results	relaxConstraints
User asks "when is cheapest to visit X?"	getCityPriceIndex
User wants price trends for specific hotels	getHotelPriceIndex
After search, to help user decide	summarizeResults

Available Tools (11 core tools)

Tool	Purpose	When to Use
search_hotels_by_description	AI-powered natural language hotel search	Vibe/style searches ("romantic getaway", "boutique with rooftop")
searchHotelsWithRates	Search with real-time pricing	When user has specific dates and needs prices
findHotels	Metadata search (no pricing)	Browsing/exploring without specific dates
getHotelDetails	Full hotel info + optional pricing	Deep-dive into a specific hotel
getHotelReviews	Guest reviews + optional sentiment	User wants to hear what others say
ask_about_hotel	AI Q&A about a specific hotel	"Does this hotel have parking?" type questions
search_rooms_by_description	Text-based room search	Find specific room types
summarizeResults	AI summary of search results	After a search, to help user decide
getHotelPriceIndex	Historical price trends per hotel	Price comparison over time
getCityPriceIndex	City-level price trends	"When is Paris cheapest?"
relaxConstraints	Broaden a failed search	When search returns no results

Agent Builder Tools (preferred on OpenClaw / Codex runtimes)

If your runtime uses OpenAI/Codex tool validation (e.g. OpenClaw), use these tools instead of the core equivalents. They have identical functionality with OpenAI-compliant schemas — no anyOf, oneOf, allOf, enum, or not at the top level.

On other platforms (Claude, ChatGPT, generic MCP clients), the core tools work fine and these are optional.

Tool	Purpose	Key Parameters
search_hotels	Use instead of searchHotelsWithRates — extended search with pricing	query (natural language), city, country, checkIn, checkOut, adults, maxPrice, minRating
get_hotel_details	Use instead of getHotelDetails — hotel details with pricing	hotelId, checkin, checkout, adults, currency
build_booking_link	Generate booking/gallery URLs from a hotelId	hotelId (required), checkin, checkout, adults, children (array of ages 0–17, max 6), currency

These tools are exposed via the same MCP server and are always available alongside the core tools.