# mcp-server MCP server

Semantic hotel search with real-time availability and price comparison for Kismet Travel

## Links
- Registry page: https://www.getdrio.com/mcp/travel-kismet-mcp-server
- Repository: https://github.com/kismet-tech/kismet-travel-mcp-v2

## Install
- Endpoint: https://mcp.kismet.travel/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.kismet.travel/mcp
- Remote endpoint: https://mcp.kismet.travel/sse

## Tools
- list_collections (List Vacation-Rental Collections) - Search the Kismet network for vacation-rental collections (property managers). Returns ranked collections with their slug (`collection_id`), regions, property count, and supported tools. Call this FIRST to find a `collection_id`, then pass it in the `collections` array to the property tools. Searchable via free-text `query` plus optional `region`/`category` filters — not a full dump. Endpoint: https://mcp.kismet.travel/mcp
- get_guest_profile (Get Kismet Guest Profile) - Get the signed-in user / guest Kismet account profile, identity, preferences, and account-level signals. Returns the currently authenticated user's (the logged-in guest's) Kismet profile: identity (first name), contact-channel status (whether an email / phone is on file and verified — never the raw values), account-level signals (linked property managers and collections the user has transacted with, plus membership status — which collections the user is an Insider member of), per-collection stay history (past and upcoming bookings with property names and dates), and a cross-collection activity summary (booking counts, last active, last booked across the Kismet network). Use this whenever the user wants to see their account, profile, or saved preferences, or whenever you need to personalize search results and recommendations for the signed-in user — common queries: "what does my profile look like", "who am I logged in as", "show my Kismet account", "check my preferences", "am I signed in", "personalize this for me". Returns an explicit anonymous state when no user is signed in. Anonymous browsing, search, and shortlisting are fully supported, so sign-in is not required for those flows. When `auth_state` is "anonymous", personal-account data (profile and identity, past stays and bookings, Insider memberships) is unavailable until the user signs in; the separate `sign_in` tool initiates the OAuth flow when the user wants to access it. This tool only READS the current auth state and never signs the user in. Endpoint: https://mcp.kismet.travel/mcp
- sign_in (Sign in to Kismet) - Trigger the Kismet OAuth sign-in flow for the current guest. Call this whenever the user explicitly asks to sign in, log in, authenticate, or connect their Kismet account — common queries: "sign me in", "log me in", "log me into Kismet", "sign me into Kismet", "connect my Kismet account", "authenticate me", "I want to log in". The host will open its OAuth WebView and run the standard PKCE handshake; after successful authentication this tool returns a confirmation snapshot of the signed-in identity (display name, email — when verified) and every subsequent tool call (get_guest_profile, get_shortlist, shortlist_property, etc.) will see the authenticated guest. Do NOT call this tool unless the user explicitly asked to sign in — anonymous browsing, search, and shortlisting all work fully without sign-in. After a successful sign-in, call get_guest_profile to surface the guest's full Kismet profile to the conversation. Endpoint: https://mcp.kismet.travel/mcp
- use_guest_token (Load Kismet guest context from a token) - Load READ-ONLY context from a Kismet guest token — e.g. a "continue in your AI assistant" link a property manager handed the guest. Returns the manager and the draft/considered itinerary the token carries (plus any current offer, when one applies), so you can have an informed conversation. This is CONTEXT ONLY: it grants NO account access and is never required for browsing. To actually claim an offer, save itinerary changes, message the manager, or book, the guest must sign in — call `sign_in` (the standard OAuth flow). Call this when the user pastes or references a Kismet guest/booking token or a kismet.travel/continue?kgt=… handoff link — pass it straight to this tool rather than browsing the URL; the token is extracted from the link. An unrecognized or expired token returns a clean invalid state (never an error) — then offer to sign them in. Endpoint: https://mcp.kismet.travel/mcp
- get_vrm_content (View Collection Info) - Returns collection-level content for a VRM. Sections: "about" (collection info), "reviews" (guest reviews with ratings). Use for guest questions about the company, area, or review quality. Endpoint: https://mcp.kismet.travel/mcp
- get_vr_reviews (View Property Reviews) - Get guest reviews for a specific vacation rental property or for the entire collection. Returns a summary and individual review texts that can be used to answer questions about guest experiences. Endpoint: https://mcp.kismet.travel/mcp
- search_properties (Search Vacation Rentals) - Primary search tool — use this whenever the guest specifies ANY filter: location, dates, budget, bedrooms, pets, or persona. Returns a ranked list of candidate properties as plain text with each property's slug, name, location, dated or anchor pricing, top personas/features, and tagline — formatted so the LLM can read and reason over them directly. After picking your top candidates from the returned list, pass their slugs to build-property-carousel to render them visually for the guest. Supports up to 5 date windows in a single call (e.g. compare March 15-18 vs March 22-25) and all location modes (region, point+radius, bounding box). Endpoint: https://mcp.kismet.travel/mcp
- get_shortlist (View Shortlist) - Show the guest's saved/shortlisted vacation rental properties for this collection. Call this when the user wants to see their saved properties or review their shortlist. Endpoint: https://mcp.kismet.travel/mcp
- discover_collections (Discover Collections) - Visually discover vacation-rental managers (collections) and their properties as an interactive carousel. OMIT `collections` to discover across the whole network (the widget shows manager filter cards plus an interleaved property carousel), pass one to feature a single manager, or several to compare. Each property card opens full details. Use this for browsing/visual presentation; use search_properties when the guest has specific filters and you want ranked text candidates. Endpoint: https://mcp.kismet.travel/mcp
- get_booking_link_vrm (Get Booking Link) - Returns a booking link for a specific vacation rental property. Use when a guest is ready to book. Endpoint: https://mcp.kismet.travel/mcp
- build_property_carousel (Build Property Carousel) - Present a curated set of specific properties as an interactive visual carousel. Pass `propertySlugs` in your chosen order, plus the collection_id(s) those properties belong to in `collections` — you get each candidate's collectionSlug from search_properties. The picks MAY span multiple managers: pass ALL their collection_ids and the carousel renders them together with manager filter cards. Never fall back to a plain text list for a cross-manager set — this tool handles it. Call AFTER search_properties. Endpoint: https://mcp.kismet.travel/mcp
- get_vr_detail (View Property Details) - Returns full details for a specific vacation rental property: description, bedrooms, bathrooms, kitchen, outdoor spaces, features, policies, and recent reviews. Use when a guest wants to know more about a specific property. Endpoint: https://mcp.kismet.travel/mcp
- shortlist_property (Save Property) - Save or remove a vacation rental property from the guest's shortlist. Reversible. Anonymous guests are tracked via the MCP session ID; signed-in guests via their guest ID — the tool reads the current identity from session context, so no auth fields need to be passed. Endpoint: https://mcp.kismet.travel/mcp

## Resources
- ui://widget/room-carousel.html - Interactive carousel of hotel room cards with images, pricing, and booking actions. MIME type: text/html;profile=mcp-app
- ui://widget/booking-button.html - Booking confirmation card with hotel, room, rate, and pricing summary plus a Book Now CTA. MIME type: text/html;profile=mcp-app
- ui://widget/discover-hotel.html - Visual hotel overview with dimension-matched expandable cards showing rooms, spaces, events, stories, and member rate teasers. MIME type: text/html;profile=mcp-app
- ui://widget/discover-vrm.html - Visual vacation rental collection overview with property carousel, pricing, and detail drawer. MIME type: text/html;profile=mcp-app
- ui://widget/shortlist-vrm.html - Guest shortlist view showing saved/favorited vacation rental properties with pricing and booking links. MIME type: text/html;profile=mcp-app
- ui://widget/membership-card.html - Collection membership join card with inline sign-in, one-tap join, explicit marketing-consent toggle, and member benefits summary. MIME type: text/html;profile=mcp-app

## Prompts
Not captured

## Metadata
- Owner: travel.kismet
- Version: 0.0.0
- Runtime: Sse, Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Sep 10, 2025
- Source: https://registry.modelcontextprotocol.io
