comment

app.py

@@ -56,53 +56,93 @@ def start_ladder_match(username: str = "MCPTrainer") -> dict:
             "message": f"Failed to start ladder battle: {str(e)}"
         }
 
+# @mcp.tool()
+# async def battle_agent(agent_type: str, username: str = "MCPTrainer", api_key: str = None, model: str = None) -> dict:
+#     """
+#     Start a battle against an AI agent.
+#     Args:
+#         agent_type (str): Type of agent ('openai', 'gemini', 'mistral', 'maxdamage', 'random')
+#         username (str): Username for the MCP-controlled player
+#         api_key (str, optional): API key for AI agents (required for openai, gemini, mistral)
+#         model (str, optional): Specific model to use (will use default if not specified)
+#     Returns:
+#         dict: Battle information including battle ID and initial state
+#     """
+#     global current_session
+#     try:
+#         # Validate agent type
+#         if agent_type.lower() not in get_supported_agent_types():
+#             return {
+#                 "status": "error",
+#                 "message": f"Unsupported agent type. Supported types: {get_supported_agent_types()}"
+#             }
+#         
+#         # Create opponent agent
+#         opponent = create_agent(agent_type, api_key=api_key, model=model)
+#         
+#         # Start battle
+#         battle_id = await start_battle_against_agent(username, opponent)
+#         
+#         current_session['username'] = username
+#         current_session['active_battle_id'] = battle_id
+#         
+#         # Get initial battle state
+#         battle_info = get_battle_state(battle_id)
+#         
+#         return {
+#             "status": "success",
+#             "battle_id": battle_id,
+#             "message": f"Battle started against {agent_type} agent",
+#             "opponent": opponent.username,
+#             "battle_url": battle_info.get('battle_url', f"https://jofthomas.com/play.pokemonshowdown.com/testclient.html#battle-{battle_id}"),
+#             "battle_state": battle_info['battle_state'],
+#             "waiting_for_move": battle_info['waiting_for_move']
+#         }
+#     except Exception as e:
+#         return {
+#             "status": "error",
+#             "message": f"Failed to start battle against agent: {str(e)}"
+#         }
+
 @mcp.tool()
-async def battle_agent(agent_type: str, username: str = "MCPTrainer", api_key: str = None, model: str = None) -> dict:
+def setup_battle() -> dict:
     """
-    Start a battle against an AI agent.
-    Args:
-        agent_type (str): Type of agent ('openai', 'gemini', 'mistral', 'maxdamage', 'random')
-        username (str): Username for the MCP-controlled player
-        api_key (str, optional): API key for AI agents (required for openai, gemini, mistral)
-        model (str, optional): Specific model to use (will use default if not specified)
+    Get setup information for playing Pokemon battles.
+    Provides instructions on how to join and play battles on the platform.
     Returns:
-        dict: Battle information including battle ID and initial state
+        dict: Setup instructions and platform information
     """
-    global current_session
-    try:
-        # Validate agent type
-        if agent_type.lower() not in get_supported_agent_types():
-            return {
-                "status": "error",
-                "message": f"Unsupported agent type. Supported types: {get_supported_agent_types()}"
-            }
-        
-        # Create opponent agent
-        opponent = create_agent(agent_type, api_key=api_key, model=model)
-        
-        # Start battle
-        battle_id = await start_battle_against_agent(username, opponent)
-        
-        current_session['username'] = username
-        current_session['active_battle_id'] = battle_id
-        
-        # Get initial battle state
-        battle_info = get_battle_state(battle_id)
-        
-        return {
-            "status": "success",
-            "battle_id": battle_id,
-            "message": f"Battle started against {agent_type} agent",
-            "opponent": opponent.username,
-            "battle_url": battle_info.get('battle_url', f"https://jofthomas.com/play.pokemonshowdown.com/testclient.html#battle-{battle_id}"),
-            "battle_state": battle_info['battle_state'],
-            "waiting_for_move": battle_info['waiting_for_move']
-        }
-    except Exception as e:
-        return {
-            "status": "error",
-            "message": f"Failed to start battle against agent: {str(e)}"
+    return {
+        "status": "success",
+        "message": "Pokemon Battle Setup Information",
+        "instructions": {
+            "how_to_play": [
+                "1. Visit the Pokemon Showdown platform at: https://huggingface.co/spaces/Jofthomas/Pokemon_showdown",
+                "2. Choose a random username for yourself",
+                "3. Use the MCP tools to start battles, make moves, and interact with the game",
+                "4. You can start ladder matches, challenge specific players, or join existing battles"
+            ],
+            "platform_url": "https://huggingface.co/spaces/Jofthomas/Pokemon_showdown",
+            "username_tip": "Choose any random username you like - it will be your identity in the Pokemon battle arena",
+            "available_battle_types": [
+                "Ladder battles (automatic matchmaking)",
+                "Player vs Player challenges",
+                "Spectate ongoing battles"
+            ]
+        },
+        "next_steps": [
+            "Visit the platform and choose your username",
+            "Use start_ladder_match() to find a random opponent",
+            "Use battle_player() to challenge a specific player",
+            "Use get_current_battle_state() to see your battle status"
+        ],
+        "platform_info": {
+            "name": "Pokemon Showdown on Hugging Face",
+            "url": "https://huggingface.co/spaces/Jofthomas/Pokemon_showdown",
+            "type": "Web-based Pokemon battle simulator",
+            "access": "Free and open to all users"
         }
+    }
 
 @mcp.tool()
 def battle_player(opponent_username: str, username: str = "MCPTrainer") -> dict: