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

Just Fieldstone Homes

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/fieldstonehomes
Every site

One 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/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 3
  • getAppointmentFormSchemaReads Fieldstone Homes' live schedule-appointment form, including its required fields and current community choices.

    Arguments

    None.

    Returns FieldstonehomesAppointmentForm

    interface 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/getAppointmentFormSchema

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    firstNamestringYes
    lastNamestringYes
    emailstringYes
    phonestringNo
    communityIdstringYes
    requestedAtstringYes
    messagestringNo
    pageUrlstringNo

    Returns FieldstonehomesPreparedAppointment

    interface 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/prepareAppointment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/searchQuickMoveIns

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.fieldstonehomes.searchQuickMoveIns({ city: "Eagle Mountain" });

Use it from code