Caruso Homes MCP server for AI agents

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

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

Connect

Just Caruso Homes

An MCP server for Caruso Homes 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/carusohomes
Every site

One MCP server for Caruso Homes 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
  • assembleTourRequestValidates a caller's tour request against a community's live form schema and maps it onto the site's own field names, ready to submit to…

    Arguments

    NameTypeRequired
    communityUrlstringYes
    firstNamestringYes
    lastNamestringYes
    emailstringYes
    phonestringNo
    desiredPriceRangeMinimumstringNo
    desiredPriceRangeMaximumstringNo
    whenToMovestringNo
    preferredAppointmentDatestring
    "YYYY-MM-DD".
    No
    messagestringNo
    textOptInbooleanNo

    Returns AssembledTourRequest

    interface AssembledTourRequest {
      valid: boolean;
      errors: string[];
      entryUrl: string;
      formFields: Record<string, string>;
      summary: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/carusohomes/assembleTourRequest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.carusohomes.assembleTourRequest({
      communityUrl: "<communityUrl>",
      firstName: "<firstName>",
      lastName: "<lastName>",
      email: "<email>"
    });
  • getTourAppointmentSchemaReads one community page's own 'Schedule a Tour' form.

    Arguments

    NameTypeRequired
    communityUrlstring
    A community URL from searchCommunities, e.g. "https://www.carusohomes.com/new-homes/md/ellicott-city/mill-creek/18641/".
    Yes

    Returns CarusoTourAppointmentSchema

    interface CarusoFormFieldOption {
      value: string;
      label: string;
    }
    
    interface CarusoFormField {
      name: string;
      label: string;
      type: "text" | "email" | "tel" | "date" | "checkbox" | "select";
      required: boolean;
      options?: CarusoFormFieldOption[];
    }
    
    interface CarusoTourAppointmentSchema {
      entryUrl: string;
      communityName: string;
      itemOfInterestId: string;
      fields: CarusoFormField[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/carusohomes/getTourAppointmentSchema

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.carusohomes.getTourAppointmentSchema({ communityUrl: "<communityUrl>" });
  • searchCommunitiesReads a Caruso Homes market listing page and returns every live community in it.

    Arguments

    NameTypeRequired
    marketstring
    E.g. "md/maryland", "nc/charlotte".
    Yes

    Returns CarusoCommunity[]

    interface CarusoCommunity {
      name: string;
      url: string;
      listingId: string | null;
      streetAddress: string | null;
      city: string | null;
      state: string | null;
      postalCode: string | null;
      latitude: number | null;
      longitude: number | null;
      description: string;
      images: string[];
      startingPriceLabel: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/carusohomes/searchCommunities

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.carusohomes.searchCommunities({ market: "md/maryland" });
  • searchFloorPlansReads a Caruso Homes market's floor-plan listing (community-attached or Build-on-Your-Lot) and returns every plan card.

    Arguments

    NameTypeRequired
    marketstringYes
    buildOnYourLotboolean
    True -> the market's Build-on-Your-Lot listing; false/omitted -> community-attached plans.
    No

    Returns CarusoFloorPlan[]

    interface CarusoFloorPlan {
      name: string;
      url: string;
      listingId: string | null;
      collection: string | null;
      priceLabel: string | null;
      priceValue: number | null;
      beds: number | null;
      baths: number | null;
      sqft: number | null;
      buildOnYourLot: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/carusohomes/searchFloorPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.carusohomes.searchFloorPlans({ market: "md/maryland", buildOnYourLot: true });

Use it from code