VibeTide MCP Server

Instructions

Implementation Reference

• vibe_tide_mcp_server.py:1034-1116 (handler)

  The core handler function for the 'create_level' MCP tool. Decorated with @mcp.tool() for registration. Takes level parameters including name, description, tiles grid, dimensions, and spawn chances; constructs level_data dict; encodes it using level_encoder; generates play URL; returns success response with data or error.
  @mcp.tool() async def create_level( level_name: str, description: str, tiles: List[List[int]], width: int = 50, height: int = 22, maxEnemies: int = 5, enemySpawnChance: float = 10.0, coinSpawnChance: float = 15.0, ) -> Dict[str, Any]: """You are an AI assistant tasked with creating fast, fun, and playable levels for the VibeTide 2D platformer game. Your role is to design levels that are engaging and balanced while adhering to specific rules and guidelines. Here are the critical rules you must follow: 1. Create levels that are EXACTLY target_width tiles wide and target_height tiles tall (default 50×22). 2. The player must spawn at the LEFTMOST solid platform in the bottom half of the level. 3. Leave 3-4 empty rows above the starting platform for jumping. 4. Design the level as a LEFT-TO-RIGHT platformer, not a maze. Use the following tile types in your level design: 0 = Empty 1 = Grass 2 = Rock 3 = Yellow 4 = Ice 5 = Red 6 = Spikes 7 = Water Follow these level design guidelines: - Bottom half: Focus on main platforms and gameplay elements - Top half: Keep mostly empty for air and jumping - Create jumpable gaps (maximum 3-4 tiles apart) - Ensure a clear left-to-right progression For difficulty parameters: - Easy levels: maxEnemies=2-3, enemySpawnChance=5-10, coinSpawnChance=20-30 - Medium levels: maxEnemies=4-6, enemySpawnChance=10-15, coinSpawnChance=15-20 - Hard levels: maxEnemies=7-10, enemySpawnChance=15-25, coinSpawnChance=10-15 Ensure that your level is exactly the specified dimensions and follows all the design rules for playability. Args: level_name: The name of the level description: A brief description of the level tiles: A 2D array of tile types width: The width of the level height: The height of the level maxEnemies: The maximum number of enemies in the level enemySpawnChance: The chance of an enemy spawning coinSpawnChance: The chance of a coin spawning """ try: # Create the level data dictionary level_data = { "name": level_name, "description": description, "tiles": tiles, "width": width, "height": height, "maxEnemies": maxEnemies, "enemySpawnChance": enemySpawnChance, "coinSpawnChance": coinSpawnChance, } # Pass the complete level_data dictionary to the encoder encoded_level = level_encoder.encode(level_data) play_url = f"{VIBE_TIDE_CONFIG['web_player_url']}?level={encoded_level}" return { "success": True, "level_data": level_data, "encoded_level": encoded_level, "play_url": play_url, "message": f"Successfully created level '{level_name}'", } except Exception as e: logger.error(f"Failed to create level with AI: {e}") return {"success": False, "error": f"Failed to create level with AI: {str(e)}"}