get_table_status
Retrieve the real-time status of a Texas Holdem poker table by providing the player ID and table ID, enabling AI agents to monitor and manage gameplay effectively.
Instructions
Get the current status of a poker table
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| player_id | Yes | ||
| table_id | Yes |
Implementation Reference
- src/mcpServer.ts:54-65 (registration)Tool registration in the listTools response, including name, description, and input schema.{ name: "get_table_status", description: "Get the current status of a poker table", inputSchema: { type: "object", properties: { player_id: { type: "string" }, table_id: { type: "string" }, }, required: ["player_id", "table_id"], }, },
- src/mcpServer.ts:57-64 (schema)Input schema definition for get_table_status tool: requires player_id and table_id as strings.inputSchema: { type: "object", properties: { player_id: { type: "string" }, table_id: { type: "string" }, }, required: ["player_id", "table_id"], },
- src/mcpServer.ts:227-236 (handler)Handler logic: Fetches table state using sendPokerRequest('getTableState') with player_id and table_id, formats it using formatTableState, and sets view_text.else if (request.params.name === "get_table_status") { // Get the current state of the table const tableState = await sendPokerRequest('getTableState', { playerId: args?.player_id, tableId: args?.table_id }); view_text = `Current status for table ${args?.table_id}:\n`; view_text += formatTableState(tableState); }
- src/mcpServer.ts:331-369 (helper)Helper function to format the table state into a readable string, used in the handler.function formatTableState(tableState: any): string { if (!tableState) return "No table state available."; let result = `Table: ${tableState.name} (ID: ${tableState.id})\n`; result += `Stage: ${tableState.stage}\n`; result += `Pot: $${tableState.pot}\n`; result += `Current Bet: $${tableState.currentBet}\n`; // Find the current active player const currentPlayer = tableState.players.find((p: any) => p.isActive); if (currentPlayer) { result += `Current Player: ${currentPlayer.name} (ID: ${currentPlayer.id})\n`; } // Community cards result += `Community Cards: ${tableState.communityCards.join(', ') || 'None'}\n\n`; // Players result += "Players:\n"; tableState.players.forEach((player: any) => { result += `- ${player.name}: $${player.chips} chips`; if (player.isDealer) result += " (Dealer)"; if (player.isSmallBlind) result += " (Small Blind)"; if (player.isBigBlind) result += " (Big Blind)"; if (player.isActive) result += " (Active)"; if (player.folded) result += " (Folded)"; if (player.isAllIn) result += " (All-In)"; result += ` - Bet: $${player.bet}\n`; // Show hand if available if (player.hand && player.hand.length > 0) { result += ` Hand: ${player.hand.join(', ')}\n`; } }); return result; }
- src/mcpServer.ts:174-195 (helper)Helper function to send requests to the poker server via socket.io, called by the handler.function sendPokerRequest(method: string, params: any): Promise<any> { return new Promise((resolve, reject) => { const request = { method, params, id: Date.now() }; //console.log(`[Client] Sending request: ${method}`, params); socket.emit('action', request, (response: any) => { //console.log(`[Client] Received response for ${method}:`, response); if (response.error) { console.error(`[Client] Error in ${method}:`, response.error); reject(response.error); } else { resolve(response.result); } }); }); }