Skip to main content
skill CX Codex

moodtrip-hotel-search — Claude Code skill for hotel search

moodtrip-hotel-search is a Claude Code skill for searching MoodTrip.ai hotels, comparing prices and reviews, and getting a booking link. You complete the reservation on MoodTrip.

MIT-0 7 installs ★ 1 updated 2026-03-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add adiny/moodtrip-hotel-search --skill moodtrip-hotel-search -a claude-code
Open on GitHub

What moodtrip-hotel-search does

The skill connects an agent to MoodTrip.ai hotel search tools. Give it a destination and dates to find options with prices, or describe the kind of stay you want to search by mood or style. You can also ask about a particular hotel or request guest reviews.

Booking is handed off through a link. The agent helps you compare options, while you finish the reservation on the MoodTrip website. The MCP server accepts hotel search parameters and is read-only; no credentials are needed to connect.

MoodTrip tools must be available in the Claude Code session before a search can run. If the server is configured but its tools do not appear, restart the session: some platforms load MCP tools only when a session starts.

What it helps with

  • find hotels for a destination and dates
  • compare prices across accommodation options
  • search for a stay by describing its style
  • check guest reviews for a hotel
  • get a link to complete a booking

Example prompts for the agent

  • Find hotels in Rome for these dates and compare their prices.
  • Search for a quiet stay using this trip description.
  • Show me guest reviews for this hotel and a booking link.

How to install moodtrip-hotel-search

1Skills CLI (Vercel)

npx skills add adiny/moodtrip-hotel-search --skill moodtrip-hotel-search -a claude-code

2Manually: put the files in place

~/.claude/skills/moodtrip-hotel-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/moodtrip-hotel-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about moodtrip-hotel-search

How do I install moodtrip-hotel-search in Claude Code?

Run npx skills add adiny/moodtrip-hotel-search --skill moodtrip-hotel-search -a claude-code. The skill file is at ~/.claude/skills/moodtrip-hotel-search/SKILL.md.

What does moodtrip-hotel-search do?

It connects an agent to MoodTrip.ai hotel search tools to find and compare stays, check hotel details or reviews, and hand off a booking link.

Do I complete the reservation through the agent?

No. The agent provides a link, and you finish the reservation on the MoodTrip website. The MCP server is read-only.

Source text

SKILL.md · MIT-0
---
name: moodtrip-hotel-search
description: Search, compare, evaluate, and hand off hotel bookings using the MoodTrip.ai MCP server (api.moodtrip.ai). Use this skill whenever the user mentions hotels, accommodation, lodging, stays, travel bookings, hotel search, hotel comparison, hotel reviews, hotel pricing, or anything related to finding or booking a place to stay. Also trigger when the user asks about hotel amenities, room types, check-in/check-out logistics, travel destinations with accommodation needs, or says things like "find me a hotel", "where should I stay", "book a room", "hotel recommendations", or "compare hotels". This skill connects to the MoodTrip MCP server which provides real-time hotel inventory, pricing, semantic search, reviews, and booking link handoff via LiteAPI.
---

# 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.

© adiny · MIT-0 · adiny/moodtrip-hotel-search

Similar skills

All skills for Agent setup: memory, context, orchestration →
FlyBest Travel — Hotel Booking with Advisor Benefits flybestorg-cyber FlyBest Travel — Hotel Booking with Advisor Benefits is an MCP server for Claude Code that searches hotels by dates and guest count, compares rates with agency perks, and helps make, review, or cancel bookings. CX Codex +1 ★ 3repo stars Hotel & Vacation Rental MCP - live prices & reviews across Booking, Airbnb, Vrbo & Google Hotels stayingapi Hotel & Vacation Rental MCP - live prices & reviews across Booking, Airbnb, Vrbo & Google Hotels is an MCP server for Claude Code that queries live rates and reviews for rentals and hotels. CX Codex +1 ScraperCompany: hotel, rental and flight prices scrapercompany ScraperCompany: hotel, rental and flight prices is an MCP server for Claude Code that delivers live hotel, flight, and vacation rental prices for travel research and OTA comparisons. CX Codex +1 Tripadvisor Search tripadvisor Tripadvisor Search — an MCP server for searching hotels, restaurants, and attractions in Tripadvisor's database directly from your IDE. No API key required. CX Codex +1 967installs travel-search-and-booking-api-and-skills alibaba-flyai travel-search-and-booking-api-and-skills — a Claude Code plugin that searches flights, hotels, tours, and concerts through the Fliggy API. Processes natural language queries and returns structured results with direct booking links. ★ 1,295repo stars Gondola Award Travel Search gondola-ai Gondola Award Travel Search puts cash and points prices side by side for hotels, flights and rental cars. Useful when you are deciding whether a redemption beats paying. CX Codex +1 ★ 11repo stars

Project sponsors

Companies that keep this analytics open