Fieldstone Homes MCP server for AI agents
Let Claude, ChatGPT or your own agent read Fieldstone Homes: 3 typed functions through one MCP server. No Fieldstone Homes API key needed.
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Fieldstone 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/fieldstonehomesOne MCP server for Fieldstone 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.
getAppointmentFormSchemaReads Fieldstone Homes' live schedule-appointment form, including its required fields and current community choices.Arguments
None.
Returns
FieldstonehomesAppointmentForminterface FieldstonehomesFormOption { value: string; label: string; } interface FieldstonehomesFormField { name: string; label: string; type: string; required: boolean; options?: FieldstonehomesFormOption[]; } interface FieldstonehomesAppointmentForm { action: string; fields: FieldstonehomesFormField[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fieldstonehomes/getAppointmentFormSchemaCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fieldstonehomes.getAppointmentFormSchema();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fieldstonehomes.getAppointmentFormSchema())curl -X POST https://api.bowmark.ai/v1/sites/fieldstonehomes/getAppointmentFormSchema \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fieldstonehomes.getAppointmentFormSchema();prepareAppointmentValidates an appointment request against Fieldstone Homes' live form and returns the exact values plus handoff URL needed to submit it.Arguments
Name Type Required firstNamestringYes lastNamestringYes emailstringYes phonestringNo communityIdstringYes requestedAtstringYes messagestringNo pageUrlstringNo Returns
FieldstonehomesPreparedAppointmentinterface FieldstonehomesPreparedAppointment { valid: boolean; errors: string[]; action: string; handoffUrl: string; fields: Record<string, string>; checkout: FieldstonehomesCheckoutHandoff; } // The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders. // Switch on `status`; a status you do not recognise means "show the person `url` and stop". interface FieldstonehomesCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; // the https page to open on the site urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page reason?: string; // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart detail?: string; // unavailable only: one sentence saying why account: { site: string; hint: string; signedInAs?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fieldstonehomes/prepareAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fieldstonehomes.prepareAppointment({ firstName: "<firstName>", lastName: "<lastName>", email: "<email>", communityId: "<communityId>", requestedAt: "<requestedAt>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fieldstonehomes.prepareAppointment({ "firstName": "<firstName>", "lastName": "<lastName>", "email": "<email>", "communityId": "<communityId>", "requestedAt": "<requestedAt>" }))curl -X POST https://api.bowmark.ai/v1/sites/fieldstonehomes/prepareAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"firstName":"<firstName>","lastName":"<lastName>","email":"<email>","communityId":"<communityId>","requestedAt":"<requestedAt>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fieldstonehomes.prepareAppointment({ firstName: "<firstName>", lastName: "<lastName>", email: "<email>", communityId: "<communityId>", requestedAt: "<requestedAt>" });searchQuickMoveInsSearches Fieldstone Homes' live quick-move-in inventory by city, home type, price, beds or sqft, returning current address, price, plan…Arguments
Name Type Required citystringNo homeTypestringNo minPricenumberNo maxPricenumberNo minBedsnumberNo minSqftnumberNo Returns
FieldstonehomesQuickMoveIn[]interface FieldstonehomesQuickMoveIn { id: string; address: string; city: string; state: string; price: number; homeType: string; planName: string; sqft: number; beds: number; baths: number; availability: string | null; incentive: string | null; imageUrl: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/fieldstonehomes/searchQuickMoveInsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.fieldstonehomes.searchQuickMoveIns({ city: "Eagle Mountain" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.fieldstonehomes.searchQuickMoveIns({"city": "Eagle Mountain"}))curl -X POST https://api.bowmark.ai/v1/sites/fieldstonehomes/searchQuickMoveIns \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"city":"Eagle Mountain"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.fieldstonehomes.searchQuickMoveIns({ city: "Eagle Mountain" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/fieldstonehomes/<function> - OpenAPI
/v1/sites/fieldstonehomes/openapi.json