MCP Server v1

Valpas Hotels MCP

Hotel search and recommendations for Valpas-protected accommodations — hotels equipped with patented bed-bug prevention technology. Carousel and map view rendered directly inside Claude, ChatGPT, and any MCP Apps host.

Overview

The Valpas Hotels MCP exposes two tools that let an AI assistant search the Valpas-verified hotel network on behalf of the user:

Search — find hotels by city, neighborhood, price, style, or rating. Returns a ranked carousel with map view rendered inline.
Details — full information for a specific hotel: amenities, photos, rating breakdown, reviewer profile, and a deep link to book on the property's own site.

Every result is from the Valpas-protected network — accommodations using Valpas's patented bed-bug prevention technology. The MCP is search and recommendation only: it never takes payment or holds reservations. Booking happens on the operator's site via the link in each result card.

Coverage. Hotels in 21 countries: Finland, Denmark, France, Greece, Iceland, Netherlands, Belgium, Italy, United Kingdom, Spain, Switzerland, Portugal, Indonesia, Germany, Sweden, Japan, Ireland, Cyprus, Norway, Malta, and Poland.

Not for. Airbnbs, apartments, hostels, vacation rentals, restaurants, flights, car rentals, attractions, or general travel guides — Valpas only covers Valpas-verified hotels.

Quick start

Claude (web & desktop)

Open Settings → Connectors in Claude and find Valpas in the directory.
Connect the app and approve the requested permissions. The two tools (search_hotels and get_hotel_details) appear in the tool picker.
Start a new chat and ask a hotel question — Claude calls the tool automatically and renders the result inline.

ChatGPT

In ChatGPT, open the apps directory and find Valpas.
Enable the app for your account.
Start a new chat and ask a hotel question — ChatGPT renders the carousel inline.

Generic MCP client

POST JSON-RPC to /mcp with Content-Type: application/json and Accept: application/json, text/event-stream. Stateless Streamable HTTP transport — the MCP protocol version is negotiated per connection (the server accepts every version supported by the latest @modelcontextprotocol/sdk release it ships with). Widget HTML is served at ui://widgets/apps-sdk/<name>.html (Apps SDK hosts) and ui://widgets/ext-apps/<name>.html (MCP Apps hosts).

Both supported hosts run the widget in a sandboxed iframe. No personal data leaves your chat — search inputs are sent to Valpas's hotel database, and results are rendered locally in the iframe.

Tools

`search_hotels`

Searches the Valpas-verified hotel network with progressive filter relaxation on zero matches.

Parameter	Type	Notes
q	string	Optional. Free-text query — typically a city or country (e.g. "Paris", "Helsinki"). Accepts `query` as an alias.
min_rating	number	Optional. Minimum TripAdvisor rating (0–5).
price_levels	string[]	Optional. One or more of `"$"`, `"$$"`, `"$$$"`, `"$$$$"`.
neighborhoods	string[]	Optional. Neighborhood names (e.g. `"Sentier"`).
styles	string[]	Optional. Style tags (e.g. `"Boutique"`, `"Luxury"`, `"Family"`).
limit	number	Optional. Default 10, max 25.
offset	number	Optional. For pagination — default 0.

Returns hotel id, name, rating, review count, price level, location (city, country, neighborhoods), styles, hero image, and booking / website URLs. If zero matches, the tool retries with progressively relaxed filters and surfaces a note explaining what was relaxed.

`get_hotel_details`

Returns the full record for a single hotel. Pass either id from a search result or name for fuzzy lookup.

Parameter	Type	Notes
id	string	Optional. Valpas hotel id (UUID) from a search result, or a TripAdvisor location id.
name	string	Optional. Hotel name — fuzzy-matched against the network.

Returns everything search_hotels returns, plus full description, address, amenities list, photo gallery, rating breakdown, reviewer-profile percentages (business / couples / solo / family / friends), and TripAdvisor ranking string. One of id or name is required.

Example queries

Natural-language prompts that work out of the box:

Find me hotels in Paris
Boutique hotels in Helsinki under $$$
Which Paris hotel has a pool?
Family-friendly hotels in Copenhagen
Tell me more about Hotel Du Sentier
Show me the highest-rated hotels in Barcelona

Data & privacy

Source. Valpas-verified hotel database backed by TripAdvisor metadata.
Identifiers. Host-supplied session and user ids are HMAC-SHA256-hashed before any telemetry leaves the process. The widget receives the hashed values via the tool result's _meta.session so widget events join with tool-call events without exposing raw identifiers.
No payment / no PII. Booking happens on the property's own site via the link in each result card. No card numbers, no contact details — those never reach this server.
Telemetry. Anonymized event stream powered by @listo-ai/mcp-observability: mcp_session, mcp_request (with sanitized args), and ui_event (impressions, clicks).

Troubleshooting

Widget didn't render

The widget is iframe-cached per conversation. If you tweak host settings or reconnect, the easiest fix is to start a new chat. Verify your host actually supports MCP Apps — basic MCP support without app rendering will still call the tool but won't show the carousel.

Search returned 0 results

The tool automatically relaxes filters (drops neighborhoods first, then widens price levels, then drops styles) and includes a note in the response explaining what was relaxed. If you still get nothing, the country may not be on the supported list — see Overview.

Booking link opens in same tab

The CTA uses the MCP ui/open-link notification to ask the host to open the URL externally. Some hosts implement this by navigating the iframe in-place rather than opening a new tab. That's a host limitation — try cmd-click / ctrl-click on the link to force a new tab if your host honors browser-level click modifiers.

Support

For Valpas-related questions — reach out to hello@valpashotels.com.

For technical issues with this MCP server — email support@listoai.co.