VibeTide MCP Server

Instructions

Args:
    encoded_level: An encoded level string from a URL or sharing link
    row: Row index to replace (0-based, from top)
    new_row_tiles: Array of tile types for the new row (each 0-7)

Returns the modified level data with the entire row replaced.

Implementation Reference

• vibe_tide_mcp_server.py:818-905 (handler)

  The core handler function for the 'edit_level_row' tool. Decorated with @mcp.tool(), it decodes the input encoded level string, validates the row index and new row tiles array (ensuring correct length and tile types 0-7), replaces the specified row in the 2D tiles array, re-encodes the level, generates an ASCII visualization, computes a play URL, and returns a comprehensive response with the updated level data, encoded string, visualization, and change summary.

  @mcp.tool()
  async def edit_level_row(
      encoded_level: str, row: int, new_row_tiles: List[int]
  ) -> Dict[str, Any]:
      """Edit an entire row in a VibeTide level.
  
      Args:
          encoded_level: An encoded level string from a URL or sharing link
          row: Row index to replace (0-based, from top)
          new_row_tiles: Array of tile types for the new row (each 0-7)
  
      Returns the modified level data with the entire row replaced.
      """
      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 row index
          if row < 0 or row >= height:
              return {
                  "success": False,
                  "error": f"Invalid row {row} - must be 0-{height-1}",
              }
  
          # Validate new row tiles
          if not isinstance(new_row_tiles, list):
              return {"success": False, "error": "new_row_tiles must be a list"}
  
          if len(new_row_tiles) != width:
              return {
                  "success": False,
                  "error": f"new_row_tiles length {len(new_row_tiles)} doesn't match level width {width}",
              }
  
          # Validate tile types
          for i, tile_type in enumerate(new_row_tiles):
              if not isinstance(tile_type, int) or tile_type < 0 or tile_type > 7:
                  return {
                      "success": False,
                      "error": f"Invalid tile type {tile_type} at position {i} - must be integer 0-7",
                  }
  
          # Make the edit
          old_row = tiles[row].copy()
          tiles[row] = new_row_tiles.copy()
  
          # 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)
  
          return {
              "success": True,
              "level_data": edited_level,
              "encoded_level": encoded_level,
              "play_url": play_url,
              "visualization": visualization,
              "change_summary": f"Replaced row {row}: {old_row} → {new_row_tiles}",
              "message": f"Successfully edited row {row}",
          }
  
      except Exception as e:
          logger.error(f"Failed to edit level row: {e}")
          return {"success": False, "error": f"Failed to edit level row: {str(e)}"}