Log inSubmit server
Cuddlynest MCP logo

Cuddlynest MCP

Searches CuddlyNest destinations and hotels, then reads listing rooms, prices, availability, and cancellation policies.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cuddlynest MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "cuddlynest-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cuddlynest-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 2 tools correctly (6d ago).

Overview

The cuddlynest-mcp MCP server searches CuddlyNest destinations and retrieves hotel listing data through public APIs and rendered listing pages. Its two read-only tools return top hotel matches, static property details, room offers, prices, availability, and cancellation policies. Listing details use Playwright with Chromium to let CuddlyNest’s JavaScript render room data before extracting it. Use it for hotel discovery and comparison when booking or payment actions are not required.

Use cases

  • Search hotel options for a destination
  • Compare CuddlyNest room prices
  • Check room availability for specific dates
  • Review cancellation policies before booking elsewhere
  • Retrieve hotel amenities and ratings

Key features

  • Destination and hotel search
  • Static hotel listing details
  • Rendered room and price extraction
  • Availability and cancellation policy data
  • Read-only stdio and Streamable HTTP transports
  • Optional broader city hotel lists

Tools2

What Cuddlynest MCP lets your agent do. Expand a tool for its parameters.

Verified live~769 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 40d

What it can do

From the 2 tools this server returned when we ran it; 2 declare their own safety hints.

Makes network requests · 2Read-only tools · 2
Network at startup4 connections
Files written at startupNone
Install scriptspostinstall, prepare
npm provenanceSigned build
Package age44 days
Maintainers1

Observed 2026-10-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · cuddlynest-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads224Package downloads in the last 30 days.
Last commit14d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed2Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Cuddlynest MCP works

What cuddlynest-mcp MCP server does

The cuddlynest-mcp MCP server exposes read-only access to CuddlyNest hotel discovery and listing information. It provides two tools:

  • cuddlynest_search accepts a destination such as “Cartagena, Colombia” and returns matching places plus top hotel results. Hotel records can include names, listing URLs, product IDs, property types, star ratings, guest ratings, review counts, images, distance from the city center, and featured amenities.
  • cuddlynest_listing_details accepts a listing URL or numeric product ID and returns static property information alongside room offers when dates are supplied. Room data can include the room title, partner, price, currency, remaining rooms, guest capacity, cancellation policy, price breakdown, and room filters.

Search results are not CuddlyNest’s complete inventory. The server uses autosuggestions and, when it can resolve and verify the destination, a broader geo-page hotel list. Prices and room availability come from the listing-details tool rather than the destination search tool.

How it works

Destination searches call CuddlyNest’s public autosuggestion service and may query a public geo-page endpoint for a larger city list. The server also uses public product-detail data to resolve product IDs and listing paths.

For a listing lookup, the server fetches static metadata from the hotel page, including structured ld+json and Open Graph information. To obtain rooms and prices, it launches a Playwright-controlled Chromium browser, waits for the page’s JavaScript to render offers, and extracts the rendered result from the page’s React component data. This is a read-only process; the tools do not create bookings, submit payments, or modify listings.

Setup and configuration

Install the published npm package with the standard MCP configuration using npx -y cuddlynest-mcp. Node.js 18 or newer is required. Playwright’s Chromium browser is installed during npm install; if that postinstall step is blocked, install it separately with npx playwright install chromium.

The cuddlynest-mcp MCP server uses stdio by default. It can also run over Streamable HTTP with node dist/index.js --http 8080, or by setting MCP_TRANSPORT=http and PORT. The HTTP endpoint is /mcp, and /health provides a liveness response.

CUDDLYNEST_SCRAPE_TIMEOUT_MS controls how long the browser waits for prices to appear and defaults to 35,000 milliseconds. Add --ignore-robots-txt to bypass robots.txt checks for listing-page fetches. Claude Desktop users can install an MCPB release bundle, but Chromium still needs to be installed separately.

Tools and capabilities

cuddlynest_search accepts a required destination. Optional guest and stay fields are echoed for downstream use. hotelsOnly removes place suggestions, while fullCityList enables the broader hotel lookup and defaults to true.

cuddlynest_listing_details requires hotel. To retrieve rooms and pricing, provide checkin and checkout in YYYY-MM-DD format. Guest counts, room count, and currency are optional; the default currency is USD and the default occupancy is two adults in one room.

Limitations and notes

The cuddlynest-mcp MCP server depends on CuddlyNest’s current frontend structure for room extraction. A frontend change to the React props used by the scraper can result in no extracted rooms even when prices remain visible on the site. The end-to-end scraper test is intended to detect this condition.

The fromPriceText value may be absent because it uses a looser text heuristic. The extracted rooms.fromPrice value is the more reliable cheapest-unit figure when room extraction succeeds. Search returns top matches rather than full inventory, and the tools cannot book rooms or process payments.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cuddlynest MCP

cuddlynest-mcp is an MCP server that connects AI agents to CuddlyNest’s public hotel APIs and listing pages. Its main tools, `cuddlynest_search` and `cuddlynest_listing_details`, find hotels and read property details, rooms, prices, availability, and cancellation policies without booking or payment actions.

Install it through npm with `npx -y cuddlynest-mcp` in an MCP client configuration. Node.js 18+ and a Playwright Chromium build are required; npm installs Chromium automatically, or you can run `npx playwright install chromium` manually.

Yes, the listing-details tool returns room prices when `checkin` and `checkout` dates are provided. The destination search tool does not return prices; pass its hotel `productId` to `cuddlynest_listing_details` instead.

No, cuddlynest-mcp is read-only and cannot book rooms or process payments. It only searches destinations and reads hotel listings, room offers, prices, availability, and cancellation policies.

Yes, it works with Claude Desktop through the stdio configuration or an MCPB release bundle. The bundle does not include Chromium, so install the Playwright browser separately after using that installation method.

Related MCP servers

All in Travel & Transportation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCuddlynest MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/cuddlynest-mcp?style=directory)](https://allmcps.com/mcp/cuddlynest-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/cuddlynest-mcp"><img src="https://allmcps.com/api/badge/cuddlynest-mcp?style=directory" alt="Cuddlynest MCP on AllMCPs" /></a>