Public MCP documentation

Travel honesty

Shipped: search_stay_packages (public)

The web MCP exposes national best-value short-term stay packages via the Travel packages path - not nearest-hotel OTA scraping.

  • Origin-based package search (traveler home base).
  • Nights constrained to 3 | 7 | 14 | 21 | 28.
  • When inventory is thin or empty, the tool returns an honesty envelope

instead of inventing listings, prices, or coverage claims.

Shipped: search_month_hops (public)

Multi-hop bounce-month plans for nomads / between-cities stays:

  • Classic hop geometry (5-night bridge + 14-night mid + rest of calendar month), or explicit nights[].
  • One packages search per hop; totalBudget split proportional to hop nights.
  • Tight month budget (≤~$1000 or ≤$40/night) auto-prefers private_room.
  • Empty hops return structure + honesty — never invent listings for a hop.

What is NOT claimed

  • Not a full OTA replacement.
  • Not "every city, every night" inventory.
  • No fabricated national coverage numbers.
  • Food / cost-of-living packs may exist on the web product; do not invent them

as MCP tools unless they appear in tools/list.

For agents

  1. Call tools/list and only use named tools that appear.
  2. Prefer package results + honesty fields over guessing lodging.
  3. Point humans to https://houseofvibes.app/dashboard/travel for the full UI.