Grand Welcome MCP server for AI agents

Let Claude, ChatGPT or your own agent read Grand Welcome: 4 typed functions through one MCP server. No Grand Welcome API key needed.

Functions
4
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Grand Welcome

An MCP server for Grand Welcome 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/grandwelcome
Every site

One MCP server for Grand Welcome and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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 4
  • getRentalDetailReads one rental's own detail page in full.

    Arguments

    NameTypeRequired
    rentalIdstringYes

    Returns GrandwelcomeRentalDetail

    interface GrandwelcomeRentalDetail {
      rentalId: string;
      propertyId: string;
      name: string;
      description: string;
      images: string[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/grandwelcome/getRentalDetail

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.grandwelcome.getRentalDetail("66bfc20154508e0016f1536e");
  • getRentalQuoteRuns the site's own real-time date-specific pricing engine for one property.

    Arguments

    NameTypeRequired
    propertyIdstringYes
    options{ checkin: string; checkout: string }Yes

    Returns GrandwelcomeQuote

    interface GrandwelcomeQuoteFee {
      label: string;
      amountUsd: number;
    }
    
    type GrandwelcomeQuote =
      | { available: true; propertyId: string; checkin: string; checkout: string; currency: "USD";
          rentUsd: number; fees: GrandwelcomeQuoteFee[]; feesTotalUsd: number; taxUsd: number;
          totalUsd: number; bookNowUrl: string }
      | { available: false; propertyId: string; checkin: string; checkout: string };

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/grandwelcome/getRentalQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.grandwelcome.getRentalQuote("1281", { checkin: "2027-06-01", checkout: "2027-06-04" });
  • listGrandwelcomeDestinationsThe entry door: reads the site's own /sitemap.xml for every published destination page and returns each one's slug (the exact vocabulary…

    Arguments

    None.

    Returns GrandwelcomeDestination[]

    interface GrandwelcomeDestination {
      slug: string;
      label: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/grandwelcome/listGrandwelcomeDestinations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.grandwelcome.listGrandwelcomeDestinations();
  • searchRentalsRuns Grand Welcome's own destination search (a real market slug like "california-sea-ranch", optionally filtered by bedroom count) and returns the…

    Arguments

    NameTypeRequired
    destinationSlugstringYes
    options{ bedrooms?: number }No

    Returns GrandwelcomeRentalRow[]

    interface GrandwelcomeRentalRow {
      rentalId: string;
      name: string;
      url: string;
      location: string;
      propertyType: string;  // the site's own labels, read the values off a result, never guess one from prose
      petFriendly: boolean;
      priceFromUsd: number | null;
      priceFromFormatted: string | null;
      bedrooms: number | null;
      bathrooms: number | null;
      guests: number | null;
      ratingValue: number | null;
      ratingCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/grandwelcome/searchRentals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.grandwelcome.searchRentals("california-sea-ranch", { bedrooms: 3 });

Use it from code