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.
- Site
- carusohomes.com
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/carusohomesOne 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/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.
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
Name Type Required communityUrlstringYes firstNamestringYes lastNamestringYes emailstringYes phonestringNo desiredPriceRangeMinimumstringNo desiredPriceRangeMaximumstringNo whenToMovestringNo preferredAppointmentDatestring"YYYY-MM-DD".No messagestringNo textOptInbooleanNo Returns
AssembledTourRequestinterface AssembledTourRequest { valid: boolean; errors: string[]; entryUrl: string; formFields: Record<string, string>; summary: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/carusohomes/assembleTourRequestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carusohomes.assembleTourRequest({ communityUrl: "<communityUrl>", firstName: "<firstName>", lastName: "<lastName>", email: "<email>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carusohomes.assembleTourRequest({ "communityUrl": "<communityUrl>", "firstName": "<firstName>", "lastName": "<lastName>", "email": "<email>" }))curl -X POST https://api.bowmark.ai/v1/sites/carusohomes/assembleTourRequest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"communityUrl":"<communityUrl>","firstName":"<firstName>","lastName":"<lastName>","email":"<email>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.carusohomes.assembleTourRequest({ communityUrl: "<communityUrl>", firstName: "<firstName>", lastName: "<lastName>", email: "<email>" });getTourAppointmentSchemaReads one community page's own 'Schedule a Tour' form.Arguments
Name Type Required communityUrlstringA community URL from searchCommunities, e.g. "https://www.carusohomes.com/new-homes/md/ellicott-city/mill-creek/18641/".Yes Returns
CarusoTourAppointmentSchemainterface 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/getTourAppointmentSchemaCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carusohomes.getTourAppointmentSchema({ communityUrl: "<communityUrl>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carusohomes.getTourAppointmentSchema({"communityUrl": "<communityUrl>"}))curl -X POST https://api.bowmark.ai/v1/sites/carusohomes/getTourAppointmentSchema \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"communityUrl":"<communityUrl>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.carusohomes.getTourAppointmentSchema({ communityUrl: "<communityUrl>" });searchCommunitiesReads a Caruso Homes market listing page and returns every live community in it.Arguments
Name Type Required marketstringE.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/searchCommunitiesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carusohomes.searchCommunities({ market: "md/maryland" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carusohomes.searchCommunities({"market": "md/maryland"}))curl -X POST https://api.bowmark.ai/v1/sites/carusohomes/searchCommunities \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"market":"md/maryland"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required marketstringYes buildOnYourLotbooleanTrue -> 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/searchFloorPlansCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carusohomes.searchFloorPlans({ market: "md/maryland", buildOnYourLot: true });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carusohomes.searchFloorPlans({"market": "md/maryland", "buildOnYourLot": True}))curl -X POST https://api.bowmark.ai/v1/sites/carusohomes/searchFloorPlans \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"market":"md/maryland","buildOnYourLot":true}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.carusohomes.searchFloorPlans({ market: "md/maryland", buildOnYourLot: true });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/carusohomes/<function> - OpenAPI
/v1/sites/carusohomes/openapi.json