VibeTide MCP Server

Instructions

Implementation Reference

• vibe_tide_mcp_server.py:729-816 (handler)

  The core handler function for the 'edit_level_tile' MCP tool. It decodes the input encoded level string, validates row, column, and new tile type parameters, modifies the specific tile in the 2D tiles array, re-encodes the level, generates a visualization and play URL, and returns the updated level data. The @mcp.tool() decorator handles both registration and schema definition via the docstring.
  @mcp.tool() async def edit_level_tile( encoded_level: str, row: int, col: int, new_tile_type: int ) -> Dict[str, Any]: """Edit a single tile in a VibeTide level. Args: encoded_level: An encoded level string from a URL or sharing link row: Row index (0-based, from top) col: Column index (0-based, from left) new_tile_type: New tile type (0-7, see tile legend) Returns the modified level data with the single tile changed. """ try: # Decode the level first try: level_data = level_encoder.decode(encoded_level) except Exception as e: return { "success": False, "error": f"Failed to decode level: {str(e)}", } tiles = level_data["tiles"] if not isinstance(tiles, list) or not tiles: return {"success": False, "error": "Invalid tiles array"} height = len(tiles) width = len(tiles[0]) if tiles else 0 # Validate coordinates if row < 0 or row >= height: return { "success": False, "error": f"Invalid row {row} - must be 0-{height-1}", } if col < 0 or col >= width: return { "success": False, "error": f"Invalid column {col} - must be 0-{width-1}", } # Validate tile type if new_tile_type < 0 or new_tile_type > 7: return { "success": False, "error": f"Invalid tile type {new_tile_type} - must be 0-7", } # Make the edit old_tile_type = tiles[row][col] tiles[row][col] = new_tile_type # Create new level data edited_level = level_data.copy() edited_level["tiles"] = tiles # Generate encoded version try: encoded_level = level_encoder.encode(edited_level) play_url = f"{VIBE_TIDE_CONFIG['web_player_url']}?level={encoded_level}" except Exception as e: logger.warning(f"Failed to encode edited level: {e}") encoded_level = None play_url = None # Generate visualization visualization = visualize_level(edited_level) old_tile_name = TILE_TYPES.get(old_tile_type, {"name": "Unknown"})["name"] new_tile_name = TILE_TYPES.get(new_tile_type, {"name": "Unknown"})["name"] return { "success": True, "level_data": edited_level, "encoded_level": encoded_level, "play_url": play_url, "visualization": visualization, "change_summary": f"Changed tile at ({row}, {col}) from {old_tile_name} to {new_tile_name}", "message": f"Successfully edited tile at position ({row}, {col})", } except Exception as e: logger.error(f"Failed to edit level tile: {e}") return {"success": False, "error": f"Failed to edit level tile: {str(e)}"}
• vibe_tide_mcp_server.py:733-742 (schema)

  The docstring of the handler defines the input schema (parameters: encoded_level (str), row (int), col (int), new_tile_type (int)) and output description for the MCP tool.
  """Edit a single tile in a VibeTide level. Args: encoded_level: An encoded level string from a URL or sharing link row: Row index (0-based, from top) col: Column index (0-based, from left) new_tile_type: New tile type (0-7, see tile legend) Returns the modified level data with the single tile changed. """
• vibe_tide_mcp_server.py:42-51 (helper)

  Global TILE_TYPES dictionary referenced in the handler for tile names and descriptions used in change_summary and validation context.
  TILE_TYPES = { 0: {"name": "Empty", "symbol": "⬜", "description": "Walkable air space"}, 1: {"name": "Grass", "symbol": "🌱", "description": "Standard ground platform"}, 2: {"name": "Rock", "symbol": "🗿", "description": "Solid stone platform"}, 3: {"name": "Yellow", "symbol": "⭐", "description": "Special yellow platform"}, 4: {"name": "Ice", "symbol": "❄️", "description": "Slippery ice platform"}, 5: {"name": "Red", "symbol": "🔥", "description": "Dangerous red platform"}, 6: {"name": "Spikes", "symbol": "⚠️", "description": "Hazardous spikes"}, 7: {"name": "Water", "symbol": "💧", "description": "Water tiles"}, }
• vibe_tide_mcp_server.py:326-327 (helper)

  Global instance of LevelEncoder class used by the handler for decoding and encoding level data.
  level_encoder = LevelEncoder()