Texas Holdem MCP Server

Instructions

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);
        }
      });
    });
  }