GoForth Public API and Agent Tools
Connect to GoForth's public property catalog through MCP, WebMCP, or Markdown. Read current listings and cite their source pages. Public catalog reads do not require an account or API key.
MCP
Connect a Streamable HTTP MCP client to https://www.goforthglobal.com/api/mcp. Initialize the session and call tools/list to inspect the current schemas.
The server supports home search, home detail, destinations, FAQs, glossary definitions, comparisons, and an inquiry tool. The inquiry tool sends contact details to GoForth and requires the buyer’s explicit consent; catalog reads do not submit inquiries.
WebMCP and the read-only catalog API
On supporting browsers, GoForth registers the following read-only tools. Browsers without WebMCP can use the same ordinary pages and links.
search_homes: Search GoForth's published vacation homes by destination slug, minimum bedrooms, and maximum USD price per 1/4 interest. Returns current available/pending homes; onlyAvailable narrows to homes with interests for sale. Default limit 20, maximum 50. Results include canonical listing URLs.get_home: Read a GoForth property by its URL slug. Returns price per 1/4 interest in USD, total property value, bedrooms, amenities, availability, description and canonical URL. Does not reserve or purchase a home.list_destinations: List GoForth's published destinations, including upcoming locations, their slugs and canonical URLs. Use a slug to filter search_homes.compare_homes: Compare 2 to 4 GoForth properties by slug. Returns their prices per 1/4 interest in USD, bedrooms, availability and descriptions side by side as structured data. Reports unavailable slugs explicitly.
Applications can also POST JSON to /api/storefront:
{
"tool": "search_homes",
"input": {
"minBedrooms": 3,
"maxPricePerShare": 500000,
"onlyAvailable": true
}
}OpenAPI specification. Invalid requests return 400; rate limits return 429 with Retry-After; content outages return 503. This endpoint never submits leads, books stays, or changes ownership data.
Prices and availability
Price filters refer to a one-quarter interest, in USD, not the entire property. Available and pending homes can appear in search; sold homes are excluded from search but may still be retrieved directly. Draft and noindex entries are excluded. Results link to canonical property pages. Confirm final pricing and availability with GoForth.
Markdown
Send Accept: text/markdown to the homepage, homes, destinations, blog, FAQ, glossary and case-study pages, or individual comparison pages. HTML remains the default. Draft, noindex and unknown entries do not have public Markdown representations.