Connect Claude, ChatGPT, Cursor, Codex and other AI apps to The Club House, then set up and run tournaments and cash games, fill the roster and read league stats by asking.
The Club House runs a remote MCP server. Connect it to the AI app you already use, such as Claude, ChatGPT, Cursor or Codex, and that app can set up and run tournaments and cash games, register players and answer questions about your league in the clubs you run. There is nothing to install and no API key to manage: you sign in with your Club House account and approve the connection.
MCP is part of the Premium plan, and it is your own plan that counts. Administering a Premium club does not include it. On Free, you can still open the setup and see what it does.
Your app works in clubs where you are an owner or administrator. Clubs where you are a member are not available to it.
You need an AI app that supports remote MCP servers with OAuth sign-in. Every app in this guide does.
Every app connects to the same address:
https://theclubhousepoker.com/mcpOpening that address in a browser shows the setup page, with one-click installs for the apps that support them. The same steps are in Settings, under MCP.
On a Team or Enterprise plan, an owner adds the connector under Organization settings, then each member selects Connect and signs in with their own Club House account.
Custom MCP servers depend on your ChatGPT plan, and a workspace admin can turn them off.
claude mcp add --transport http --scope user theclubhouse https://theclubhousepoker.com/mcp/mcp, choose theclubhouse and select Authenticate.Prefer to edit the file yourself? Add this to ~/.cursor/mcp.json instead:
{
"mcpServers": {
"theclubhouse": { "url": "https://theclubhousepoker.com/mcp" }
}
}codex mcp add theclubhouse --url https://theclubhousepoker.com/mcpcodex mcp login theclubhousePrefer a workspace file? Add this to .vscode/mcp.json instead:
{
"servers": {
"theclubhouse": { "type": "http", "url": "https://theclubhousepoker.com/mcp" }
}
}On Copilot Business or Enterprise, an admin has to allow MCP servers.
gemini mcp add --transport http theclubhouse https://theclubhousepoker.com/mcp/mcp auth theclubhouse{
"mcpServers": {
"theclubhouse": { "serverUrl": "https://theclubhousepoker.com/mcp" }
}
}Any app that supports remote MCP servers with OAuth can connect. Add a remote (Streamable HTTP) server with the server URL. Your app finds the sign-in on its own, so there is no API key to create or paste.
The first time your app uses The Club House, it opens our sign-in in your browser. Sign in, and the approval screen shows:
The account the app will act for. If it is the wrong one, select Switch account: the request is cancelled and you are signed out, so you can connect again from your app with the right account.
The clubs it will reach: every club you own or administer. If you have none yet, you can still connect and create a club later.
Where you will be sent back once you approve. If an app's name does not match where it sends you, the screen warns you that it may not be the real app. Only allow it if you trust that destination.
Select Allow and you are handed back to your app, or Cancel to refuse. No account yet? Create one from the sign-in screen and you come straight back to finish connecting. On Free, the approval screen offers the upgrade instead, and returns you to it after checkout.
Connection requests expire after a few minutes and can be used once. If one has expired, start again from your app.
Every club you own or administer, including clubs you create or are promoted in after connecting. Access is checked on every request, so a role change applies to your app straight away, in both directions.
What you could see yourself in those clubs: tournaments and their setup, cash games and their ledgers, rosters, members' names and pictures, leagues, results and stats.
Your own profile: your name and email, so your app knows who it is acting for.
It never sees other members' email addresses, passwords or payment details, and it cannot reach clubs where you are only a member. What your app does with what it reads is covered by its own privacy policy, so connect only apps you trust.
What tournaments do we have coming up this month?
Create a tournament for next Friday at 7pm with a $50 buy-in, using our usual blind structure.
Copy last week's tournament to next Thursday with the same settings and the same players.
Register Marco, Iris and Theo for Friday's tournament, and add my friend Sam as a guest.
Open registration for Saturday's game.
Start the clock. Theo is out, Marco knocked him out.
Iris rebuys. How many players are left, and what is the average stack?
Set up tonight's 1/2 cash game with buy-ins from $100 to $300, and open registration.
How much is in play at tonight's cash game, and who is up?
Who is leading the season leaderboard, and by how many points?
Compare my results with Theo's this season, head to head.
Who holds the club records for wins and longest streak?
How did I play my hands in last night's tournament?
Who has won the most at our cash games this year?
Your app looks up clubs, leagues, members and tournaments by name, so you rarely need an ID. If a name matches more than one, your app is told which ones matched, so it can ask you.
Give your app a name, a date and time, a buy-in and how many places are paid. You can also set:
The league or season it counts towards, or no league.
The location.
Freezeout or rebuy, with the number, cost and chips of rebuys and add-ons.
The starting stack and the maximum number of players.
The blind structure: one of the bundled structures, one your club has saved, or levels and breaks you describe.
The game: Hold'em, Omaha, Omaha Hi-Lo, Seven Card Stud, Stud Hi-Lo, Five Card Draw, 2-7 Single Draw or Razz, with no-limit, pot-limit or limit betting, or a mixed rotation of several games. Choosing the game needs the club owner to be on Premium; otherwise it is No-Limit Hold'em.
The lobby layout, from the layouts your club has saved.
Self-registration: whether anyone with the tournament's link can register themselves.
Payouts: percentages of the prize pool or fixed amounts per place, rounding, a fixed prize pool and a bounty per knockout.
Registration closing on its own: when a level ends, some minutes after the start, or at a set time.
Unless you say otherwise, a new tournament is a freezeout, its starting stack comes from the blind structure, self-registration is on, and registration starts closed. Ask your app to open it when you are ready.
Say the date and time as you would to a person. Your app sends it with your time zone; check the time it reports back.
Your app can change any of the settings above until the tournament starts. It reads the tournament first, and if someone changes it in The Club House before your app saves, the change is refused rather than overwriting theirs. Your app reads it again and retries.
Copying keeps the whole setup and gives the copy a new name, date and time, and optionally a new location. Ask for the same players too and the roster comes along.
Open registration to accept players, and close it to stop, before the start or during late registration. While it is open, members register in The Club House, and anyone with the tournament's link can register themselves when self-registration is on. Your app can register players either way.
Your app can list a club's tournaments, all of them or only those that are upcoming, running, finished or cancelled, and read the full setup and state of any one.
Find members by name, and see who is registered for a tournament.
Register several members at once. Only active members of the club can be registered.
Add a guest: someone without an account joins the club as a guest, with just a name, and is registered in one step.
Remove players from a tournament.
Players can be registered until the tournament finishes, so late entries work; seat them in The Club House. Removing a player is possible until it starts. A tournament with a maximum number of players refuses more once it is full.
The clock: start the tournament, pause and resume, go to the next or previous level or to any level, set the time left on the level, and move a mixed game to its next game. Changing level pauses the clock, as it does on screen, so ask your app to resume.
Eliminations: a player finishes in the place of the players still in, is paid that place's prize and any bounties, and leaves their seat. Say who knocked them out and it counts as their knockout. Taking out second place ends the tournament and crowns the winner.
Undo: an elimination made by mistake can be reversed while the tournament runs, and the prizes are worked out again.
Rebuys and add-ons, one at a time, within the tournament's limits.
Payouts can change at any time, a deal at the final table included. Prizes already won follow the new payouts.
Status and results: where the clock is, players left, average stack, prize pool and payouts, and every player's place, prize and knockouts.
Set up a session: stakes that hold all night or rise on a schedule, the buy-in range and default, a minimum top-up, a rebuy limit, straddles, the game, the league it counts towards, and registration. Copy last week's.
Run the clock: start the session, pause and resume, and move the stakes to the next level or any level.
Follow it: the money in play, every player's buy-ins, cash-outs and net result, and the full ledger.
Amounts are in your club's currency. Buy-ins, rebuys, cash-outs and the settlement are recorded in The Club House, where the host handles the money.
Leaderboards: the full ranking for a league or season, with places, wins, points, win rate and largest payout, or just where you stand.
League stats: earnings, knockouts, attendance, rebuys, add-ons and prize pools.
Records: who holds the season records for wins, streaks, payouts, attendance, win rate and rebuys.
Chip stats: the average chips in play and blind level when tournaments reach heads-up.
Player profiles: all-time or league results for any player, or for you, with deeper stats such as when they bust, knockout trends, rebuy impact, recent form and heads-up record.
History: a player's results tournament by tournament.
Comparisons: up to five players side by side, with head-to-head records.
Cash results: a cash league's leaderboard by net result, its insights (biggest pots, top winners, regulars), and any player's cash record, session by session.
Hand review: for a finished tournament played with hand capture, your own hands, the tournament's hands, or both. Your review includes only your own hole cards; of other players' cards, only a showdown winner's can appear. It covers the cards dealt, not bets, pots or stacks.
Name the club or league when you have more than one. Without one, your app uses the newest active league in your clubs: a tournament league for tournament stats, a cash league for cash results.
Every change carries a unique request ID, so a retried request never creates a second tournament, registers a player twice or eliminates a player twice.
Each tool tells your app whether it only reads, adds something, or changes and removes something. Apps that ask before acting, such as Claude, use that to ask you before edits, removals, eliminations and clock changes.
Every change your app makes is recorded with the connection that made it.
When an app sends too many requests or changes in a short time, nothing happens and it is told how many seconds to wait. The same request is then safe to send again.
MCP needs your account to be on Premium. Premium's limits are sized for running your own club's games. If you need more, for a venue or for events run largely through your app, the Enterprise plan raises them for your account.
If your plan changes to Free, connected apps stay listed in Settings, under MCP, but are paused: their tools answer with an upgrade message. Upgrade again and they work straight away, without reconnecting.
Open Settings and choose MCP to see every connected app and when it was connected. Select Disconnect to revoke one. It loses access immediately, and you can connect it again at any time.
Your app says MCP is part of Premium. Your account is on a plan without MCP. Upgrade from Settings, under MCP, then try again.
A club is missing. Your app only sees clubs where you are an owner or administrator. Ask the club owner to change your role.
The sign-in page says the request expired. Connection requests last a few minutes and work once. Go back to your app and connect again.
You signed in with the wrong account. Select Switch account on the approval screen, then connect again from your app. If you already approved it, disconnect the app in Settings first.
The tools do not show up. Make sure The Club House is turned on for the chat, or authenticate it again from your app's MCP settings.
Your app was told to wait. It sent too many requests or changes in a short time, and nothing was done. Wait the number of seconds it was given and retry. If this happens often, ask about higher limits on Enterprise.
A tournament's setup cannot be changed. Setup changes stop once a tournament starts. Use the clock, elimination and payout tools, or make the change in The Club House.
A cash game cannot be changed. Once a session is settled, it is final.
Your app cannot record a buy-in or settle a game. Cash money is recorded in The Club House, not by apps. Your app can still read every buy-in and result.
Your app says the tournament changed since it read it. Someone edited it in the meantime. Ask your app to read it again and retry.
A player cannot be registered. Only active members can be registered. Add them as a guest, or invite them to the club first. A full tournament also refuses more players.
Choosing the game is refused. Games other than No-Limit Hold'em need the club owner to be on Premium.
Only approve connections you started yourself, and check where the approval screen says it will send you back. If you see an app in Settings that you do not recognise, disconnect it and change your password.