Places
States, provinces and countries are written as full names, such asFlorida, Ontario and United States. Two-letter state codes such as FL also resolve, in the API and in the MCP tools. Full names are the safer choice.
In the API, country also takes an ISO code such as GB. A state with no country stays in the US and Canada, so send country too for a region elsewhere.
In the MCP tools, state covers US states and Canadian provinces only. In search_clubs, a query with a place after a comma, such as Naples, FL or Sydney, Australia, keeps the search to that state or country. See place names.
Types
Types are lower case snake_case, such asgolf, yacht and country_club. See Club types for the 15 current types and how the API groups them.
Waitlist values
waitlist_status holds one of these values:
The field can also be
null, which also means not known. In the API, waitlist=by_invitation matches both by_invitation and invite_only. In the MCP tools, waitlist: true keeps open clubs only.
Waitlist status can change. Point people to the club’s profile before they act on it.
Profile links
MCP results carry aurl for each club’s profile, in this form:
url is null when a club has no region. Use the url the tool returns. API rows carry no profile link.
Fees
Never state, estimate or imply a club’s fees. Private Clubs never returns membership fees over MCP, and API calls from your server or script return none. Account holders see fees on each club’s profile at theprivateclubs.com.Missing values
null means the value is not known. Leave the field out of what you show, or point people to the club’s profile. Never invent a value.