⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

moodtrip-hotel-search

adiny@adiny⭐ 1 stars· last commit 7mo ago· 0 open issues

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.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 1 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

MoodTrip Hotel Search Skill

A Claude AI skill for searching, comparing, evaluating, and booking hotels through the MoodTrip.ai MCP server.

What It Does

This skill connects to https://api.moodtrip.ai/api/mcp-http and gives Claude (or any MCP-compatible agent) the ability to:

  • Search hotels by destination, dates, budget, and natural language ("romantic getaway with rooftop bar")
  • Compare hotels side-by-side with ratings, prices, and amenities
  • View reviews with AI-powered sentiment analysis
  • Explore rooms by description or photo upload
  • Track pricing trends for cities and specific hotels
  • Hand off booking via direct booking links to moodtrip.ai

Tools Covered

ToolPurpose
searchHotelsWithRatesSearch with real-time pricing
searchHotelsSemanticQueryAI-powered natural language search
quickHotelSearchSimplified single-room search
findHotelsBrowse hotels without pricing
getHotelDetailsFull hotel info + optional pricing
getHotelReviewsGuest reviews + sentiment analysis
askHotelQuestionAI Q&A about a specific hotel
searchRoomsVisual/text room search
summarizeResultsAI summary of search results
getHotelPriceIndexHotel price trends
getCityPriceIndexCity-level price trends
relaxConstraintsBroaden a failed search

Plus 3 optional Agent Builder tools (build_booking_link, search, fetch).

Installation

Option 1: ClawHub

Import directly from ClawHub — search for moodtrip-hotel-search.

Option 2: Claude Project

Copy the contents of SKILL.md into your Claude Project's custom instructions.

Option 3: .skill file

Download moodtrip-hotel-search.skill from Releases and import it into Claude.

MCP Server

  • Endpoint: https://api.moodtrip.ai/api/mcp-http
  • Protocol: MCP Streamable HTTP (JSON-RPC 2.0)
  • Auth: Public for search (no API key needed). OAuth 2.1 optional for session tracking.
  • Booking: Link-based handoff — user completes booking on moodtrip.ai

Quick Start

No setup needed. The MCP server is live and free to call for search operations.

To connect from Claude Desktop, add to your claude_desktop_config.json:

{
  "mcpServers": {
    "moodtrip": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.moodtrip.ai/api/mcp-http"]
    }
  }
}

Example Interactions

Search with pricing:

"Find me hotels in Paris for May 1-4, under $200/night"

Semantic search:

"Romantic boutique hotel with rooftop bar in Tel Aviv"

Hotel deep-dive:

"Tell me more about the second hotel — reviews, photos, and is breakfast included?"

Price intelligence:

"When is the cheapest time to visit London?"

Data Source

Hotel inventory, pricing, and reviews are provided by LiteAPI.

License

MIT-0 (No Attribution Required)

Links

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md7.8 KBupstream ↗
    ---
    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 thi
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/adiny-moodtrip-hotel-search.md

// REPO STATS

1 stars
0 open issues
Last commit: 7mo ago