# hemmabo-mcp-server MCP server

Vacation rental booking infrastructure for independent hosts. 0% commission. MCP + Stripe ACP.

## Links
- Registry page: https://www.getdrio.com/mcp/com-hemmabo-hemmabo-mcp-server
- Repository: https://github.com/HemmaBo-se/hemmabo-mcp-server
- Website: https://hemmabo.com

## Install
- Command: `npx -y hemmabo-mcp-server`
- Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Npm hemmabo-mcp-server v3.2.4
- Environment variable: SUPABASE_URL (required)
- Environment variable: SUPABASE_SERVICE_ROLE_KEY (required; secret)
- Environment variable: SUPABASE_ANON_KEY (required; secret)
- Environment variable: STRIPE_SECRET_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://hemmabo-mcp-server.vercel.app/mcp

## Tools
- hemmabo_search_properties - Search available vacation rental properties by location and travel dates. Use this tool when the user wants to find or browse properties — it is the entry point for all booking flows. Do NOT use if the user already has a specific propertyId; use hemmabo_search_availability or hemmabo_booking_quote instead. Returns a list of available properties with propertyId, live pricing (public and federation rates), and capacity info needed for subsequent tools. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_search_availability - Check whether a specific property is available for the requested dates. Use this tool after the user has selected a property from hemmabo_search_properties and wants to confirm availability before getting a quote. Do NOT use for general browsing — use hemmabo_search_properties instead. Returns available=true/false with conflict details and same-month alternative date windows when unavailable. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_search_similar - Find vacation rental properties similar to a given property on specific dates. Use this tool after the user has selected a property (via hemmabo_search_properties) and wants to see alternatives — same region, same property type, same or larger capacity. Do NOT use for the initial search; use hemmabo_search_properties instead. Returns a list of similar available properties with live pricing, excluding the source property. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_compare_properties - Compare availability and pricing for 2–10 specific properties on the same dates. Use this tool when the user is deciding between multiple properties and wants to see price and availability side by side. Do NOT use for discovery — use hemmabo_search_properties first. Returns one entry per propertyId, sorted by federation price (cheapest first), with unavailable properties last. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_booking_quote - Get a detailed pricing quote for a specific property, dates, and guest count. Use this tool after confirming availability to show the user exact pricing before booking. Do NOT use before checking availability — the quote may be invalid if dates are unavailable. Returns publicTotal (website rate), federationTotal (direct booking discount), gapTotal (gap-night discount if applicable), per-night breakdown, and package pricing. All prices are integers in the property's local currency (e.g. SEK). Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_booking_create - Create a direct booking without online payment (legacy flow). Use this tool when the user wants to book without Stripe payment — the booking is created with status 'pending' and requires host approval. Do NOT use for paid bookings — use hemmabo_booking_checkout instead. Do NOT retry on timeout without calling hemmabo_booking_status first to avoid duplicate bookings. Returns bookingId, final price, and confirmation details. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_booking_negotiate - Create a binding price quote that locks the price for 15 minutes. Use this tool before hemmabo_booking_checkout to guarantee the quoted price during payment. Do NOT skip this step if the user wants price certainty — without a quoteId, checkout calculates a fresh price that may differ. Returns quoteId (pass to hemmabo_booking_checkout), public and federation totals, per-night breakdown, and expiry timestamp. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_booking_checkout - Create a booking with Stripe payment and return a checkout URL. Use this tool when the user is ready to pay — it creates the booking record and generates a Stripe payment page. Do NOT call twice for the same booking — check hemmabo_booking_status first to avoid double charges. Optionally pass quoteId from hemmabo_booking_negotiate to lock the price. Returns reservationId, paymentUrl (Stripe checkout page), and pricing details. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_booking_cancel - Cancel a confirmed booking and process the Stripe refund. Use this tool when the guest explicitly requests cancellation. Do NOT use for pending/unpaid bookings — those expire automatically. Refund amount is calculated based on the host's cancellation policy. Returns cancellation confirmation with refund amount and status. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_booking_status - Retrieve current status and full details of an existing booking. Use this tool to check payment status, confirm a booking went through, or look up details before rescheduling or cancelling. Use after hemmabo_booking_checkout if unsure whether the booking succeeded. Returns booking dates, guests, price, status, property info, and cancellation policy. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- hemmabo_booking_reschedule - Reschedule a confirmed or pending booking to new dates. Use this tool when the guest wants to change travel dates on an existing booking. Do NOT use if the booking is cancelled or completed — check hemmabo_booking_status first. Automatically recalculates price and handles Stripe charge (if price increased) or refund (if decreased). Returns previous dates, new dates, price delta, and Stripe transaction details. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- verify_vacation_rental_node - Verify a Vacation Rental Protocol host-domain node. Reads https://{domain}/.well-known/vacation-rental.json and the node JWKS, confirms VRP v0.1, canonical host-domain control, Ed25519 signing keys, and the verified stay offer endpoint. Use before trusting or quoting a host-domain offer. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp
- get_verified_stay_offer - Fetch a signed VRP verified_stay_offer from a verified host-domain node and verify its Ed25519 compact JWS against that domain's JWKS. Reads the production signature.jws envelope, checks payload match and freshness, and returns agent guardrails so clients quote only signed availability, exact price, and direct booking URL. Never invent discounts or OTA comparisons outside the signed offer. Endpoint: https://hemmabo-mcp-server.vercel.app/mcp

## Resources
- ui://hemmabo/property-card - ChatGPT Apps SDK widget that renders hemmabo_search_properties results as a grid of property cards with image, location, public vs federation (direct-booking) price, host-controlled discount badge, and a CTA linking to the property's own host-owned domain. MIME type: text/html

## Prompts
- trip.plan - Help plan a vacation rental trip. Guides the agent through the full booking lifecycle: searching properties, getting a binding quote, completing payment via Stripe checkout, and managing the booking (status checks, rescheduling, cancellation). Provide destination, dates, and guest count to get started. Arguments: destination, checkIn, checkOut, guests

## Metadata
- Owner: com.hemmabo
- Version: 3.2.4
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Apr 21, 2026
- Source: https://registry.modelcontextprotocol.io