# Private Clubs

> Documentation for the Private Clubs MCP server and REST API

- [Introduction](https://docs.theprivateclubs.com/introduction.md): Search and compare private clubs from your AI app or your own product, free and without an account
- [How Private Clubs works](https://docs.theprivateclubs.com/how-clubs-works.md): One clubs directory, served to AI apps through MCP and to your product through the REST API
- [API quickstart](https://docs.theprivateclubs.com/api/index.md): Make your first request to the Private Clubs API in five steps
- [MCP quickstart](https://docs.theprivateclubs.com/mcp/getting-started.md): Connect Private Clubs to your AI app and ask your first question
- [Find and compare clubs](https://docs.theprivateclubs.com/guides/members.md): Search clubs by place and type, compare a shortlist and check membership status from your AI app
- [Check your club's listing](https://docs.theprivateclubs.com/guides/clubs.md): See your club the way AI apps see it, compare it with clubs nearby and claim the listing
- [Build a list of clubs](https://docs.theprivateclubs.com/guides/brands-and-creators.md): Pull clubs by type and region for research, with the API for longer lists
- [Look up the club behind a listing](https://docs.theprivateclubs.com/guides/real-estate-agents.md): Find the clubs in a town, check membership status and compare courses for a buyer
- [Use cases](https://docs.theprivateclubs.com/use-cases.md): Questions people bring from their AI app, by audience, with a prompt you can adapt
- [Shortlist clubs to join](https://docs.theprivateclubs.com/use-cases/members.md): Search clubs, compare a shortlist and check whether a waitlist is open, from your AI app
- [See how your club reads in AI apps](https://docs.theprivateclubs.com/use-cases/clubs.md): Read your profile as AI apps see it and compare it with clubs in your state
- [Map clubs by type and region](https://docs.theprivateclubs.com/use-cases/brands-and-creators.md): Find the clubs of one type in a state before you plan outreach or research
- [Answer club questions for buyers](https://docs.theprivateclubs.com/use-cases/real-estate-agents.md): Name the clubs in a town, check membership status and compare golf courses for a buyer
- [Check the club before you buy a home](https://docs.theprivateclubs.com/use-cases/home-buyers.md): Find the golf clubs in a town, check a club's waitlist and compare two clubs side by side
- [Install Private Clubs](https://docs.theprivateclubs.com/mcp/connect.md): Add the Private Clubs MCP server to Claude, ChatGPT, Claude Code, Codex, Cursor, Grok, Perplexity, OpenClaw, Hermes or any other AI app
- [Available tools](https://docs.theprivateclubs.com/mcp/tools.md): The five tools on the Private Clubs MCP server, with every parameter and returned field
- [Troubleshooting](https://docs.theprivateclubs.com/mcp/troubleshooting.md): Fix common problems with the Private Clubs MCP server, from missing tools to empty results
- [API overview](https://docs.theprivateclubs.com/api/openapi.md): Spec, base URL, errors and versioning for the Private Clubs API
- [Authentication and fees](https://docs.theprivateclubs.com/api/authentication.md): No keys or accounts, and what fee data each caller sees
- [Pricing and limits](https://docs.theprivateclubs.com/api/usage-limits.md): What the Private Clubs MCP server and API cost, the data license, page sizes and the request limits on each surface
- [Club object](https://docs.theprivateclubs.com/reference/club-object.md): Every field a club carries in API responses and MCP tool results
- [Club types](https://docs.theprivateclubs.com/reference/club-types.md): The 15 club types, how the API groups them and where legacy types go
- [Conventions](https://docs.theprivateclubs.com/reference/conventions.md): How Private Clubs writes places, types, waitlist values and links, and how to cite it
- [Discovery files](https://docs.theprivateclubs.com/reference/discovery-files.md): The public files that tell AI apps and crawlers where to find the Private Clubs MCP server and API
- [Search clubs](https://docs.theprivateclubs.com/api-reference/clubs/search-clubs.md): Searches the Private Clubs directory by type, place, name and waitlist status, with paging. Rows come sorted by name. A page past the last one answers 200 with an empty clubs array and the real total. Fees follow the caller's access (see Club.fee_views). Errors use RFC 9457 application/problem+json,…

## OpenAPI Specs

- [openapi](https://www.theprivateclubs.com/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.