AvantStay MCP server for AI agents
Let Claude, ChatGPT or your own agent read AvantStay: 2 typed functions through one MCP server. No AvantStay API key needed.
- Site
- avantstay.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just AvantStay
An MCP server for AvantStay alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/avantstayEvery site
One MCP server for AvantStay and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
getPricingPrices every room type at one AvantStay hotel-style property for a given date range and guest count.Arguments
Name Type Required hotelIdstringYes hashstringYes checkInstringYes checkOutstringYes guestsnumberYes Returns
AvantstayPricinginterface AvantstayRoomPrice { hotelRoomTypeId: string; title: string; availableUnits: number; pricePerNight: number | null; priceBeforeFees: number | null; priceTotal: number | null; fees: Array<{ name: string; amount: number }>; nights: number | null; unavailableReason: string | null; } interface AvantstayPricing { hotelId: string; hash: string; checkIn: string; checkOut: string; guests: number; rooms: AvantstayRoomPrice[]; bookingUrl: string; // The handoff: give the person checkout.url (dates and party are in it) and stop. // status "unavailable" means no room type is open. Bowmark never books. checkout: { status: string; url: string; urlKind?: string; reason?: string; detail?: string; account: { site: string; hint: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null }[]; total: string | null; currency: string; dates?: { start: string; end?: string }; guests?: number } | null; warnings: string[] } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/avantstay/getPricingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.avantstay.getPricing("7f4fde2d-b547-46cf-adb4-44ac025e682a", "764011", { $daysFromNow: 9 }, { $daysFromNow: 12 }, 2);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.avantstay.getPricing("7f4fde2d-b547-46cf-adb4-44ac025e682a", "764011", {"$daysFromNow": 9}, {"$daysFromNow": 12}, 2))curl -X POST https://api.bowmark.ai/v1/sites/avantstay/getPricing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"hotelId":"7f4fde2d-b547-46cf-adb4-44ac025e682a","hash":"764011","checkIn":{"$daysFromNow":9},"checkOut":{"$daysFromNow":12},"guests":2}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.avantstay.getPricing("7f4fde2d-b547-46cf-adb4-44ac025e682a", "764011", { $daysFromNow: 9 }, { $daysFromNow: 12 }, 2);searchPropertiesRuns AvantStay's own portfolio search (the same query the site-wide search widget uses) and returns hotel-style properties.Arguments
Name Type Required minBedroomsnumberYes guestsnumberYes Returns
AvantstayProperty[]interface AvantstayProperty { name: string; city: string; region: string; stateCode: string | null; hash: string; hotelId: string; unitsCount: number | null; buildingType: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/avantstay/searchPropertiesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.avantstay.searchProperties(2, 2);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.avantstay.searchProperties(2, 2))curl -X POST https://api.bowmark.ai/v1/sites/avantstay/searchProperties \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"minBedrooms":2,"guests":2}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.avantstay.searchProperties(2, 2);
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/avantstay/<function> - OpenAPI
/v1/sites/avantstay/openapi.json